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
[
  {
    "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"
  }
]

Authorizations

​
Authorization
string
header
required

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
​
requisition_id
string

The ID of the requisition.

​
barcode
string

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

​
account_number
string

The account number submitted to the lab.

​
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
​
status
enum<string>
Available options:
created,
approved,
denied,
delivered,
received,
extra_quality_checks,
resulted,
rejected,
delivery_exception
​
created
string
​
updated
string
Create requisitionGet requisition