GET
/
api
/
v2
/
requisitions
/
curl --request GET \
  --url https://app.spotdx.com/api/v2/requisitions/ \
  --header 'Authorization: <api-key>'
[
  {
    "requisition_id": "f0e5a607-5b52-4d7c-a3f2-c40772d41482",
    "barcode": "19742938328",
    "account_number": "1234567890",
    "lab": "CRL",
    "panels": [
      "PANEL-123"
    ],
    "patient": {
      "first_name": "Alice",
      "last_name": "Smith",
      "email": "alice123@gmail.com",
      "phone": "1234567890",
      "sex": "F",
      "date_of_birth": "2023-02-08",
      "address": {
        "street1": "123 Main St",
        "street2": "Apt 1",
        "city": "San Francisco",
        "state": "CA",
        "country": "US",
        "zip": "94105"
      }
    },
    "status": "resulted"
  }
]
Access to requisitioning is disabled by default. To enable it, talk to us and we’ll get you set up

Authorizations

Authorization
string
headerrequired

Token-based authentication with required prefix "Token"

Query Parameters

lab
string

Filter by the lab name. This is case sensitive. If there is a space in the lab's name, use %20 in the url instead, eg. The Lab would become ?lab=The%20Lab

first_name
string

Filter by first name.

last_name
string

Filter by last name.

email
string

Filter by email.

phone
string

Filter by phone number.

status
string

Filter by status.

created_before
string

Only retrieve orders created on or before this date. Format: YYYY-MM-DD

created_after
string

Only retrieve orders created on or after this date. Format: YYYY-MM-DD

updated_before
string

Only retrieve orders updated on or before this date. Format: YYYY-MM-DD

updated_after
string

Only retrieve orders updated on or after this date. Format: YYYY-MM-DD

offset
integer

The offset to start the list from.

results
integer

The number of results to retrieve per page.

Response

200 - application/json
account_number
string

The account number submitted to the lab.

barcode
string

The full barcode of the sample mailed to the lab. Must be globally unique.

created
string
lab
string

The name of the lab that will process the sample.

panels
string[]

The panel codes of the test being performed on the sample. We'll create these with you during onboarding.

patient
object
requisition_id
string

The ID of the requisition.

status
enum<string>
Available options:
created,
approved,
denied,
delivered,
received,
extra_quality_checks,
resulted,
rejected,
delivery_exception
updated
string