List orders

GET /v0/labs/orders

Return every order belonging to your lab, most recently placed first.

Use start and limit to page through the results — a maximum of 100 orders are returned at a time. When more orders are available beyond the current page, more_results is true.

The list can also be narrowed to a single order status, a single client, or to orders changed since a given time.

Query parameters

start integer optional

Zero-based index of the first order to return.

Default: 0

limit integer optional

Maximum number of orders to return. Capped at 100.

Default: 100

status_id integer optional

Only return orders currently in this order status.

modified_since_time string optional

Only return orders modified after this time, e.g. 2025-03-14T09:12:44.

client_id integer optional

Only return orders placed by this client.

Try it

Log in to send test requests to this endpoint straight from the docs.

Responses

200 Success
orders array of objects
Show 13 child attributes Hide 13 child attributes
id string

Order ID

industry_id integer

Industry ID

industry_name string

Industry Name

lims_id string

Order lims ID

client_id integer

Client ID

status_id integer

Status ID

status_name string

Status Name

lab_license_number string

Lab license number under which order was tested

client_license_number string

Client license number under which order was placed

ordered_date timestamp

Order Date [when order was placed]

verified_date timestamp

Verified Date [when order was verified]

completed_date timestamp

Completed Date [when order was completed]

last_modified timestamp

Time this order was last modified

more_results boolean

True when more orders are available beyond this page.

400 Bad request

The request was malformed or failed validation. Validation failures include per-field messages in error_details.

Possible error_code values: invalid_request, request_too_old.

401 Unauthorized

Authentication failed.

Possible error_code values: missing_api_key, invalid_api_key, invalid_credentials_type, api_access_restricted, api_access_denied, missing_signature, missing_timestamp, invalid_timestamp, invalid_signature.

403 Permission denied

The API key is valid but does not have permission for this endpoint (for example, a client key calling a labs endpoint).

Possible error_code values: permission_denied.

How to sign requests
# X-ConfidentLims-Signature: see the Request Signing guide - https://api.confidentcannabis.com/v0/docs/request-signing.md
curl -X GET 'https://api.confidentcannabis.com/v0/labs/orders' \
  -H 'X-ConfidentLims-APIKey: YOUR_API_KEY' \
  -H 'X-ConfidentLims-Timestamp: UNIX_TIMESTAMP' \
  -H 'X-ConfidentLims-Signature: REQUEST_SIGNATURE'
Response · 200
{
  "success": true,
  "orders": [
    {
      "id": "2503GLL0042",
      "industry_id": 1,
      "industry_name": "Cannabis",
      "lims_id": "PO-8841",
      "client_id": 318,
      "status_id": 2,
      "status_name": "Placed",
      "lab_license_number": "C8-0000123-LIC",
      "client_license_number": "CDPH-10003456",
      "ordered_date": "2025-03-14T09:12:44",
      "verified_date": null,
      "completed_date": null,
      "last_modified": "2025-03-14T09:12:44"
    },
    {
      "id": "2503GLL0041",
      "industry_id": 1,
      "industry_name": "Cannabis",
      "lims_id": "PO-8840",
      "client_id": 318,
      "status_id": 4,
      "status_name": "Completed",
      "lab_license_number": "C8-0000123-LIC",
      "client_license_number": "CDPH-10003456",
      "ordered_date": "2025-03-11T11:38:02",
      "verified_date": "2025-03-11T16:20:55",
      "completed_date": "2025-03-13T14:05:31",
      "last_modified": "2025-03-13T14:05:31"
    }
  ],
  "more_results": false
}