Probatix Documentation
Probatix Diagnostics API v1External Activation

Activate a diagnostic test

Activates the DiagnosticTest. A specimen code is required when it was not provided during external fulfillment only. If the test already has a specimen, omit this field. If provided, the code must match the existing specimen.

POST
/v1/diagnostic_tests/{id}/activate

Activates the DiagnosticTest. A specimen code is required when it was not provided during external fulfillment only. If the test already has a specimen, omit this field. If provided, the code must match the existing specimen.

Authorization

apiKey
X-API-TOKEN<token>

In: header

Path Parameters

id*string (uuid)

DiagnosticTestActivateInput identifier

Header Parameters

accept-language?string

Language for Errors and Translatable properties

Allowed values: "de", "en", "fr"

Request Body

The new DiagnosticTestActivateInput resource

TypeScript Definitions

Use the request body type in TypeScript.

body*DiagnosticTestActivateInput
id?string (uuid)
specimenCode?string | null

Laboratory specimen code or sample identifier.

collectionDate*string (date)

Date when the specimen was collected.

collectionTime*string

Time of day when the specimen was collected.

menstrualPhaseAtCollection?string | null

Optional menstrual phase reported at collection time, when applicable.

Allowed values: "follikel", "ovulation", "luteal", "menopause", null

gender*string

Patient gender.

Allowed values: "M", "F", "D", "X"

dateOfBirth*string (date)

Patient date of birth.

healthInsuranceDetails?HealthInsuranceDetails | null

Health insurance details, when applicable for the ordered DiagnosticProduct.

countryCode?string | null
provider?string | null
healthInsuranceTypeDE?string | null

Allowed values: "GKV", "PKV", null

subscriberIdentifier?string | null

The insurer assigned ID for the Subscriber.

Response Body

curl -X POST "https://example.com/v1/diagnostic_tests/497f6eca-6276-4993-bfeb-53cbbbba6f08/activate" \  -H "accept-language: de" \  -H "Content-Type: application/json" \  -d '{    "specimenCode": "ABC-123456",    "collectionDate": "2026-05-04",    "collectionTime": "13:50:00",    "menstrualPhaseAtCollection": "luteal",    "gender": "F",    "dateOfBirth": "1994-01-15",    "healthInsuranceDetails": {      "countryCode": "DE",      "provider": "Example Insurance",      "healthInsuranceTypeDE": "GKV",      "subscriberIdentifier": "string"    }  }'
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "diagnosticOrder": "/entity/1",  "diagnosticProduct": "/entity/1",  "testResults": [    "/entity/1"  ],  "patient": {    "email": "user@example.com",    "firstName": "string",    "lastName": "string",    "gender": "M",    "dateOfBirth": "2019-08-24",    "healthInsuranceDetails": {      "countryCode": "string",      "provider": "string",      "healthInsuranceTypeDE": "GKV",      "subscriberIdentifier": "string"    }  },  "specimens": [    {      "specimenCode": "string",      "createdAt": "2019-08-24T14:15:22Z",      "collectionDate": "2019-08-24",      "collectionTime": "string",      "menstrualPhaseAtCollection": "follikel"    }  ],  "shipmentTracking": {    "provider": "DHL",    "createdAt": "2019-08-24T14:15:22Z",    "updatedAt": "2019-08-24T14:15:22Z",    "trackingCode": "string",    "url": "string",    "shipmentStatus": "confirmed",    "providerStatus": "string",    "rawProviderHistory": [      null    ]  },  "activatedAt": "2019-08-24T14:15:22Z",  "labIntakeAt": "2019-08-24T14:15:22Z",  "replacementDiagnosticTest": "/entity/1",  "replacesDiagnosticTest": "/entity/1",  "canceledAt": "2019-08-24T14:15:22Z",  "completedAt": "2019-08-24T14:15:22Z",  "fulfilledAt": "2019-08-24T14:15:22Z",  "createdAt": "2019-08-24T14:15:22Z"}

Download a document file GET

Returns the document as a binary file download. The response body is raw binary data, not JSON. Content negotiation is not used for this endpoint, and the `Accept` header is ignored. Use the response `Content-Type` and `Content-Disposition` headers to determine the actual file type and filename.

Create or update outbound shipment tracking for a diagnostic order POST

Creates or updates shipment tracking for the FulfillmentCenter -> Customer shipment of the DiagnosticOrder.