Skip to content
Probatix API Documentation

Creates a DiagnosticOrderInput resource.

POST
/v1/diagnostic_orders
curl --request POST \
  --url 'http://api.probatix.localhost/v1/diagnostic_orders?XDEBUG_SESSION=PHPSTORM' \
  --header 'Content-Type: application/json' \
  --header 'X-API-TOKEN: <X-API-TOKEN>' \
  --header 'accept-language: de' \
  --data '{ "productIds": [ "00112233-4455-6677-8899-aabbccddeeff" ], "patient": { "firstName": "Jane", "lastName": "Doe", "email": "meron.nagy@probatix.de", "gender": "M", "dateOfBirth": "1994-01-15", "healthInsuranceDetails": { "countryCode": "DE", "provider": "Example Insurance", "healthInsuranceTypeDE": "GKV", "subscriberIdentifier": "example" } }, "shippingAddress": { "address1": "Bismarckstraße 10-12", "address2": "6. OG", "zip": "10625", "city": "Berlin", "countryCode": "DE", "firstName": "Jane", "lastName": "Doe", "phone": "030 56838352", "company": "Probatix Health GmbH", "name": "Probatix Health GmbH" }, "metadata": { "yourReference1": "abc", "yourReference2": 123, "yourFlag1": true } }'

Creates a DiagnosticOrderInput resource.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Header Parameters

Section titled “Header Parameters”
accept-language
string
Allowed values: de en fr

Language for Errors and Translatable properties

Example
de

Query Parameters

Section titled “Query Parameters”
XDEBUG_SESSION
string
default: PHPSTORM

Xdebug session for debugging

Example
?XDEBUG_SESSION=PHPSTORM

Request Bodyrequired

Section titled “Request Bodyrequired”

The new DiagnosticOrderInput resource

object
productIds
required

UUIDs of the DiagnosticProducts to order. Provide at least one product ID.

Array<string>
>= 1 items
Example
[
  "00112233-4455-6677-8899-aabbccddeeff"
]
patient
required
object
firstName
required
string
Example
Jane
lastName
required
string
Example
Doe
email
required
string format: email
Example
meron.nagy@probatix.de
gender

Patient gender. Defaults to X (Unknown) when omitted.

string
default: X
Allowed values: M F D X
Example
F
dateOfBirth

Patient date of birth.

string format: date
Example
1994-01-15
healthInsuranceDetails
Any of:
object
countryCode
string | null
Example
DE
provider
string | null
Example
Example Insurance
healthInsuranceTypeDE
string | null
Allowed values: GKV PKV
Example
GKV
subscriberIdentifier

The insurer assigned ID for the Subscriber.

string | null
shippingAddress
required
object
address1
required
string
Example
Bismarckstraße 10-12
address2
string | null
Example
6. OG
zip
required
string
Example
10625
city
required
string
Example
Berlin
countryCode
string
default: DE
Example
DE
firstName
required
string
Example
Jane
lastName
required
string
Example
Doe
id
string format: uuid
phone
string | null
Example
030 56838352
company
string | null
Example
Probatix Health GmbH
name
string | null
Example
Probatix Health GmbH
metadata

Optional partner-defined metadata. Up to 10 entries are supported and values must be JSON primitive values (string, number, or boolean).

object | null
<= 10 items
Example
{
  "yourReference1": "abc",
  "yourReference2": 123,
  "yourFlag1": true
}

Responses

Section titled “Responses”

201

Section titled “201”

DiagnosticOrderInput resource created

object
id
required
string format: uuid
diagnosticTests

IRIs of the diagnostic tests that belong to this order.

Array<string>
createdAt
required

Timestamp when the order was created.

string format: date-time
shippedAt

Timestamp when the outbound shipment was handed over for transportation.

string | null format: date-time
shipmentTracking
Any of:
object
provider
required
string
Allowed values: DHL Swiss Post OTHER
createdAt
required

Timestamp when the shipment was created.

string format: date-time
updatedAt
required

Timestamp when the shipment was last updated.

string format: date-time
trackingCode
string | null
url
string format: url
shipmentStatus

Normalized shipment status for informational purposes only.

string | null
Allowed values: confirmed in_transit out_for_delivery delivered failure undeliverable returned_to_sender available_for_collection
providerStatus

Shipment status from the provider please note some Providers are not 100% reliable and will occasionally deliver shipments without status updates.

string | null
shippingAddress
Any of:
object
address1
required
string
address2
string | null
zip
required
string
city
required
string
countryCode
string
default: DE
firstName
required
string
lastName
required
string
id
string format: uuid
phone
string | null
company
string | null
name
string | null
metadata

Optional partner-defined metadata. Up to 10 entries are supported and values must be JSON primitive values (string, number, or boolean).

Array<string | null> | null
Example
{
  "diagnosticTests": [
    "/v1/diagnostic_tests/00112233-4455-6677-8899-aabbccddeeff"
  ],
  "shippedAt": "2026-05-04T09:15:00+00:00",
  "shipmentTracking": {
    "provider": "DHL",
    "trackingCode": "123",
    "url": "https://www.dhl.de/en/privatkunden/dhl-sendungsverfolgung.html?piececode=123",
    "shipmentStatus": "confirmed",
    "providerStatus": {
      "terminalStatus": true,
      "name": "DELIVERED",
      "value": "delivered"
    }
  },
  "shippingAddress": {
    "address1": "Bismarckstraße 10-12",
    "address2": "6. OG",
    "zip": "10625",
    "city": "Berlin",
    "countryCode": "DE",
    "firstName": "Jane",
    "lastName": "Doe",
    "phone": "030 56838352",
    "company": "Probatix Health GmbH",
    "name": "Probatix Health GmbH"
  },
  "metadata": {
    "yourReference1": "abc",
    "yourReference2": 123,
    "yourFlag1": true
  }
}

400

Section titled “400”

Invalid input

A representation of common errors.

object
@context
One of:
string
@id
required
string
@type
required
string
title

A short, human-readable summary of the problem.

string | null
detail

A human-readable explanation specific to this occurrence of the problem.

string | null
status
integer | null
default: 400
instance

A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.

string | null
type

A URI reference that identifies the problem type

string
description
string | null
Example
{
  "@context": {
    "hydra": "http://www.w3.org/ns/hydra/core#"
  },
  "status": 400
}

401

Section titled “401”

Unauthorized

A representation of common errors.

object
@context
One of:
string
@id
required
string
@type
required
string
title

A short, human-readable summary of the problem.

string | null
detail

A human-readable explanation specific to this occurrence of the problem.

string | null
status
integer | null
default: 400
instance

A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.

string | null
type

A URI reference that identifies the problem type

string
description
string | null
Example
{
  "@context": {
    "hydra": "http://www.w3.org/ns/hydra/core#"
  },
  "status": 400
}

403

Section titled “403”

Forbidden

A representation of common errors.

object
@context
One of:
string
@id
required
string
@type
required
string
title

A short, human-readable summary of the problem.

string | null
detail

A human-readable explanation specific to this occurrence of the problem.

string | null
status
integer | null
default: 400
instance

A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.

string | null
type

A URI reference that identifies the problem type

string
description
string | null
Example
{
  "@context": {
    "hydra": "http://www.w3.org/ns/hydra/core#"
  },
  "status": 400
}

422

Section titled “422”

An error occurred

Unprocessable entity

object
@context
One of:
string
@id
required
string
@type
required
string
status
integer
default: 422
violations
Array<object>
object
propertyPath
required

The property path of the violation

string
message
required

The message associated with the violation

string
code

The code of the violation

string
hint

An extra hint to understand the violation

string
payload

The serialized payload of the violation

object
key
additional properties
any
detail
string
description
string
type
string
title
string | null
instance
string | null
Example
{
  "@context": {
    "hydra": "http://www.w3.org/ns/hydra/core#"
  },
  "status": 422
}