---
title: "Lab lifecycle state and lab-kit tracking for one order."
method: GET
path: "/api/v1/orders/{id}/lab-status"
tags: ["Orders"]
---

# Lab lifecycle state and lab-kit tracking for one order.

`GET /api/v1/orders/{id}/lab-status`

## Request

- Base URL: `https://api-dev.fusehealth.com`
- URL: `https://api-dev.fusehealth.com/api/v1/orders/{id}/lab-status`
- Auth: API key in header `x-api-key`

Lab lifecycle STATE for one of the key clinic's orders: the current stage, a stage-by-stage timeline with timestamps, and the lab-kit shipment carrier/tracking numbers for both legs (FUSE to patient, patient to lab).

This endpoint deliberately exposes NO lab result content — no analyte values, reference ranges, interpretations, result documents, requisition PDFs, or results-review booking links. `resultsAvailableAt` is a timestamp only: it tells you the lab has reported, not what it reported.

Requires the `v1_fulfillment` endpoint group to be enabled for your clinic (contact FUSE). Returns 404 for an unknown, malformed, or another clinic's order id.

## Path parameters

- `id` string, uuid, required

## Response `200`

Success

- object
  - `success` boolean
  - `data` object
    - `orderId` string, uuid
    - `isLabGated` boolean: Whether this order uses the lab-gated split-payment flow.
    - `orderStatus` string, nullable: The order's overall status. Lab-related values include `awaiting_lab_results`, `awaiting_renewal_lab`, `authorization_failed`, `authorized_awaiting_review`.
    - `stage` 'requisition_created' | 'shipped_to_patient' | 'delivered_to_patient' | 'shipped_to_lab' | 'received_by_lab' | 'results', nullable: Current lab lifecycle stage; `null` when the order has no lab leg yet.
    - `timeline` object[]: All six stages in lifecycle order. `reached` is true for the current stage and every stage before it. `occurredAt` is null for unreached stages and for the two shipment stages, which carry carrier/tracking but no dedicated timestamp.
      - `stage` 'requisition_created' | 'shipped_to_patient' | 'delivered_to_patient' | 'shipped_to_lab' | 'received_by_lab' | 'results'
      - `reached` boolean
      - `occurredAt` string, date-time, nullable
    - `kitShipmentToPatient` object: Outbound leg — lab kit shipped to the patient.
      - `carrier` string, nullable
      - `trackingNumber` string, nullable
      - `deliveredAt` string, date-time, nullable
    - `kitShipmentToLab` object: Return leg — patient's sample shipped to the lab.
      - `carrier` string, nullable
      - `trackingNumber` string, nullable
      - `receivedAt` string, date-time, nullable
    - `resultsAvailableAt` string, date-time, nullable: When the lab reported results. TIMESTAMP ONLY — the result content itself is never exposed on this API.

## Other responses

- `403`: The `v1_fulfillment` endpoint group is not enabled for your clinic
- `404`: Order not found. Returned for an unknown id, a malformed (non-UUID) id, and an id belonging to another clinic — the three are deliberately indistinguishable.

---

[API](https://skmtc.dev/fusehealth/apis/fuse-brand-api-external.md) · [All operations](https://skmtc.dev/fusehealth/apis/fuse-brand-api-external/llms.txt) · [OpenAPI document](https://skmtc.dev/fusehealth/apis/fuse-brand-api-external/revisions/50821832728c?raw)