Skip to main content
GET
/
api
/
v2
/
requisitions
/
{id}
cURL
curl --request GET \
  --url https://app.spotdx.com/api/v2/requisitions/{id} \
  --header 'Authorization: <api-key>'
{
  "requisition_id": "f0e5a607-5b52-4d7c-a3f2-c40772d41482",
  "barcode": "19742938328",
  "account_number": "1234567890",
  "lab": "CRL",
  "panels": [
    "PANEL-123"
  ],
  "state_collected": "OH",
  "patient": {
    "first_name": "Alice",
    "last_name": "Smith",
    "email": "alice123@gmail.com",
    "phone": "1234567890",
    "sex": "F",
    "date_of_birth": "2023-12-25",
    "address": {
      "address": {
        "street1": "123 Main St",
        "city": "San Francisco",
        "state": "CA",
        "country": "US",
        "zip": "94105",
        "street2": "Apt 1"
      }
    }
  },
  "tracking": {
    "tracking_number": "9400123456789999876500",
    "carrier": "usps"
  },
  "status": "resulted",
  "events": [
    {
      "event": "created",
      "date": "2020-01-01T00:00:00Z"
    },
    {
      "event": "approved",
      "date": "2020-01-01T00:00:00Z"
    },
    {
      "event": "delivered",
      "date": "2020-01-02T00:00:00Z"
    },
    {
      "event": "received",
      "date": "2020-01-03T00:00:00Z"
    },
    {
      "event": "extra_quality_checks",
      "date": "2020-01-04T00:00:00Z"
    },
    {
      "event": "resulted",
      "date": "2020-01-05T00:00:00Z"
    }
  ],
  "reports": [
    {
      "report_id": "<string>",
      "results": [
        {
          "result_type": "quantity",
          "name": "HDL Cholesterol",
          "time_collected": "2023-01-14T04:30:11.222Z",
          "result": 123,
          "unit_of_measure": "mg/dL",
          "range_minimum": 20,
          "range_maximum": 200,
          "comments": null
        },
        {
          "result_type": "quantity",
          "name": "Vitamin B12",
          "time_collected": "2023-01-14T04:30:11.222Z",
          "result": "<10",
          "unit_of_measure": "pg/mL",
          "range_minimum": 20,
          "range_maximum": 200,
          "comments": null
        },
        {
          "result_type": "reactivity",
          "name": "Chlamydia",
          "time_collected": "2023-01-14T04:30:11.222Z",
          "result": "negative",
          "unit_of_measure": null,
          "range_minimum": null,
          "range_maximum": null,
          "comments": null
        },
        {
          "result_type": "genotype",
          "name": "rs1234567",
          "time_collected": "2023-01-14T04:30:11.222Z",
          "result": "TT",
          "unit_of_measure": null,
          "range_minimum": null,
          "range_maximum": null,
          "comments": null
        }
      ],
      "pdf": "https://app.spotkits.com/results/f0e5a607-5b52-4d7c-a3f2-c40772d41482.pdf",
      "txt": "https://app.spotkits.com/results/f0e5a607-5b52-4d7c-a3f2-c40772d41482.txt",
      "date_collected": "2023-11-07T05:31:56Z",
      "date_received": "2023-11-07T05:31:56Z",
      "date_resulted": "2023-11-07T05:31:56Z",
      "is_amendment": false
    }
  ],
  "attributes": {
    "crl_slip_id": "1234567890",
    "crl_tier3_account_number": "12345678"
  },
  "metadata": {
    "some_key": "some_value"
  },
  "created": "2020-01-01T00:00:00Z",
  "updated": "2020-01-01T00:00:00Z"
}

Documentation Index

Fetch the complete documentation index at: https://docs.spotdx.com/llms.txt

Use this file to discover all available pages before exploring further.

Access to requisitioning is disabled by default. To enable it, talk to us and we’ll get you set up

Authorizations

​
Authorization
string
header
required

Token-based authentication with required prefix "Token"

Path Parameters

​
id
string<uuid>
required

The ID of the requisition to retrieve.

Response

​
requisition_id
string

The ID of the requisition.

Example:

"f0e5a607-5b52-4d7c-a3f2-c40772d41482"

​
barcode
string

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

Example:

"19742938328"

​
account_number
string

The account number submitted to the lab.

Example:

"1234567890"

​
lab
string

The name of the lab that will process the sample.

Example:

"CRL"

​
panels
string[]

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

Example:
["PANEL-123"]
​
state_collected
string

The two letter code of the state where the sample was collected.

Example:

"OH"

​
patient
object
​
tracking
object
​
status
enum<string>
Available options:
created,
approved,
denied,
delivered,
received,
extra_quality_checks,
resulted,
rejected,
delivery_exception
Example:

"resulted"

​
events
object[]
Example:
[
  {
    "event": "created",
    "date": "2020-01-01T00:00:00Z"
  },
  {
    "event": "approved",
    "date": "2020-01-01T00:00:00Z"
  },
  {
    "event": "delivered",
    "date": "2020-01-02T00:00:00Z"
  },
  {
    "event": "received",
    "date": "2020-01-03T00:00:00Z"
  },
  {
    "event": "extra_quality_checks",
    "date": "2020-01-04T00:00:00Z"
  },
  {
    "event": "resulted",
    "date": "2020-01-05T00:00:00Z"
  }
]
​
reports
(object | null)[]
​
attributes
object

An optional set of values that can be passed through to specific labs.

Example:
{
  "crl_slip_id": "1234567890",
  "crl_tier3_account_number": "12345678"
}
​
metadata
object

An optional dictionary of key-value pairs stored with the requisition.

Example:
{ "some_key": "some_value" }
​
created
string<date-time>
Example:

"2020-01-01T00:00:00Z"

​
updated
string<date-time>
Example:

"2020-01-01T00:00:00Z"