Skip to content
Probatix API Documentation

Creates a SpecimenCollectionKitOrderInput resource.

POST
/sck/v1/orders
curl --request POST \
  --url 'http://api.probatix.localhost/sck/v1/orders?XDEBUG_SESSION=PHPSTORM' \
  --header 'Content-Type: application/json' \
  --header 'X-API-TOKEN: <X-API-TOKEN>' \
  --header 'accept-language: de' \
  --data '{ "productIds": [ "/sck/v1/products/00112233-4455-6677-8899-aabbccddeeff" ], "contact": { "firstName": "Jane", "lastName": "Doe", "email": "meron.nagy@probatix.de", "phone": "030 56838352" }, "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, "priority": true } }'

Create an SCK order. productIds accepts a UUID, canonical ID, or /sck/v1/products/{id} IRI for each product. Canonical IDs are recommended because product UUIDs are not guaranteed to match between demo and production environments.

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 SpecimenCollectionKitOrderInput resource

object
productIds
required

Identifiers of the specimen collection kit products to order. Each entry may be a UUID, an SCK product IRI, or a canonical ID. Provide at least one product ID.

Array<string>
>= 1 items
Example
[
  "/sck/v1/products/00112233-4455-6677-8899-aabbccddeeff"
]
contact
required
object
firstName
required
string
Example
Jane
lastName
required
string
Example
Doe
email
required
string format: email
Example
meron.nagy@probatix.de
phone
string | null
Example
030 56838352
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,
  "priority": true
}

Responses

Section titled “Responses”

201

Section titled “201”

SpecimenCollectionKitOrderInput resource created

object
id
required
string format: uuid
kits

IRIs of the specimen collection kits that belong to this order.

Array<string>
contact
object
firstName
required
string
lastName
required
string
email
required
string format: email
phone
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. Values must be JSON primitive values.

object | null
status
required

Current SCK order status.

string
Allowed values: new fulfilled canceled
createdAt
string | null format: date-time
shippedAt
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
Example
{
  "kits": [
    "/sck/v1/kits/00112233-4455-6677-8899-aabbccddeeff"
  ],
  "contact": {
    "firstName": "Jane",
    "lastName": "Doe",
    "email": "meron.nagy@probatix.de",
    "phone": "030 56838352"
  },
  "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,
    "priority": true
  },
  "status": "new",
  "createdAt": "2026-06-29T10:30:00+00:00",
  "shippedAt": "2026-06-30T09: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"
    }
  }
}

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
}