Skip to main content

JustLabs Partner API

Order labs, get requisitions and results — by API.

Place Quest Diagnostics orders for your patients from your own product. JustLabs handles the physician authorization, payment, the lab requisition and results delivery; you get JSON and signed webhooks.

Read the guideAPI reference
1

Get a key

Mint a sandbox key in the partner portal. Test keys (jl_test_) only work against the sandbox; production keys need a signed BAA.

Read more →2

Create an order

One POST with the patient, the tests from the catalog and an Idempotency-Key. The card on file is charged and the order is placed with the lab automatically.

Read more →3

Receive results

A signed webhook tells you when the requisition PDF and later the results are ready; fetch them with a short-lived signed URL, plus structured analytes.

Read more →

One request to place an order

Everything is JSON, money is integer cents, dates are ISO-8601, and every error is { "error": { "code", "message" } }. Replaying a request with the same Idempotency-Key is always safe.

Productionhttps://justlabs.health/api/v1jl_live_…
Sandboxhttps://labify-staging-3hnx3fg7ca-uc.a.run.app/api/v1jl_test_…
curl https://justlabs.health/api/v1/orders \
  -H "Authorization: Bearer jl_live_…" \
  -H "Idempotency-Key: enc-8812-1" \
  -H "Content-Type: application/json" \
  -d '{
    "externalId": "enc-8812",
    "patient": { "firstName": "Ana", "lastName": "Ruiz", "dateOfBirth": "1988-04-02",
                 "sex": "female", "email": "ana@example.com", "phone": "3055550123",
                 "address": { "line1": "12 Main St", "city": "Miami", "state": "FL", "zip": "33101" } },
    "items": [{ "id": "thyroid-complete" }, { "id": "lipid" }]
  }'
Published pricesThe catalog returns the exact per-test price and your account's fees.
No patient accountsPatients never see JustLabs; the experience stays inside your product.
Signed webhooksHMAC-SHA256 with a timestamp, ids-only payloads, retried with backoff.
HIPAAProduction keys are issued once a BAA is on file. Every result read is audited.