probatix
Developer · REST API

The API for lab diagnostics: order, track, receive results

The Probatix API is a REST interface that covers the complete diagnostics workflow: order test kits, follow logistics and lab status via webhooks and receive results as a FHIR R4 bundle with LOINC-coded values. One integration – from kit order to structured result.

REST FHIR R4 LOINC Webhooks <48h Time-to-Result
Book a Demo How an integration works
The flow

How an integration works

Four steps, one data flow: your system talks exclusively to the Probatix API – fulfillment, labs and report logic stay hidden behind it.

01

Create an order

Your system creates a test order via REST call – with kit variant, panel and shipping address. Probatix validates the required fields and starts fulfillment.

REST JSON
02

Receive logistics events

Dispatch, delivery, sample return and sample receipt at the lab: every status transition is reported to your system as a webhook – no polling required.

Webhooks Tracking
03

Get the result webhook

As soon as the report is medically approved, a webhook notifies your system in real time. You decide when and how the end user is informed.

Real-time Event-based
04

Retrieve the report

The report is available as structured JSON or as a FHIR R4 bundle – DiagnosticReport and Observations, LOINC-coded, with reference ranges.

FHIR R4 LOINC
FHIR R4

What a report looks like

Abridged, generic example of a FHIR R4 report: a DiagnosticReport with a LOINC-coded Observation including reference range. Real reports additionally contain specimen data and all panel parameters. 

{
  "resourceType": "DiagnosticReport",
  "status": "final",
  "code": {
    "coding": [{
      "system": "http://loinc.org",
      "code": "24331-1",
      "display": "Lipid 1996 panel - Serum or Plasma"
    }]
  },
  "issued": "2026-08-04T09:30:00+02:00",
  "result": [
    { "reference": "Observation/obs-ldl-example" }
  ]
}

{
  "resourceType": "Observation",
  "id": "obs-ldl-example",
  "status": "final",
  "code": {
    "coding": [{
      "system": "http://loinc.org",
      "code": "13457-7",
      "display": "Cholesterol in LDL [Mass/volume] in Serum or Plasma by calculation"
    }]
  },
  "valueQuantity": {
    "value": 118,
    "unit": "mg/dL",
    "system": "http://unitsofmeasure.org",
    "code": "mg/dL"
  },
  "referenceRange": [{
    "high": { "value": 116, "unit": "mg/dL" }
  }]
}

Authentication

API access uses personalised credentials that you receive during onboarding. All endpoints are reachable exclusively over TLS-encrypted connections; access is tenant-separated and logged in an auditable way.

Documentation & sandbox

We provide partners with the full API reference, a test environment and example reports during onboarding. The fastest way there: a demo call with our team.

Book a demo and request API access

Deep dive in the knowledge hub

How REST, FHIR reports and LOINC play together in day-to-day integration work is covered in the knowledge hub article Integrating lab diagnostics via API – including workflow examples for telemedicine and health apps. For the big picture: the Probatix platform and the DaaS guide.

Frequently asked questions

Lab diagnostics API: FAQ

The four questions developer teams ask most often before an integration.

Which FHIR version is supported?
Reports are delivered as a FHIR R4 bundle – with DiagnosticReport, Observation and Specimen as the central resources. Parameters are LOINC-coded and units follow UCUM. For systems without a FHIR connection, the same report is available as structured JSON.

Are there webhooks for status transitions?
Yes. All relevant status transitions – from order creation through dispatch and sample receipt to report approval – trigger webhooks. Your system stays in sync in real time without having to poll the API periodically.

How quickly are results available?
For most tests, the result is available within 48 hours of sample receipt at the lab. The result webhook fires immediately after the medical approval of the report.

Is there a test environment?
Yes. For the integration phase we provide a test environment in which orders, status transitions and example reports can be played through without any real kits being shipped. You receive access as part of onboarding – book a demo to get started.

One API. The complete diagnostics workflow.

A technical deep dive with our team: architecture, example payloads and sandbox access for your use case.

Book a Demo Explore white-label test kits