List orders

GET /v0/clients/orders

Return every order your client has placed, ordered by order date descending so the newest orders come first.

Use start and limit to page through the results (maximum 100 per page). When more results are available beyond the current page, more_results is true. Combine modified_since_time with paging to poll for changes.

Query parameters

start integer optional

Zero-based offset of the first result.

Default: 0

limit integer optional

Maximum results per page (max 100).

Default: 100

status_id integer optional

Only return orders in this order status. See the order statuses endpoint for available IDs.

modified_since_time string optional

Only return orders modified after this timestamp.

client_id integer optional

Only return orders placed with this lab.

Try it

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 if more results 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.

# 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/clients/orders' \
  -H 'X-ConfidentLims-APIKey: YOUR_API_KEY' \
  -H 'X-ConfidentLims-Timestamp: UNIX_TIMESTAMP' \
  -H 'X-ConfidentLims-Signature: REQUEST_SIGNATURE'

import time
import requests

# sign_request() is defined in the Request Signing guide:
# https://api.confidentcannabis.com/v0/docs/request-signing.md
from sign_request import sign_request

API_KEY = 'YOUR_API_KEY'
API_SECRET = 'YOUR_API_SECRET'
path = '/v0/clients/orders'

params = {
    # optional query params go here - they are signed too
}

headers = {'X-ConfidentLims-Timestamp': str(int(time.time()))}
headers['X-ConfidentLims-Signature'] = sign_request(
    'GET', path, headers, params, API_KEY, API_SECRET)
headers['X-ConfidentLims-APIKey'] = API_KEY

response = requests.get(
    'https://api.confidentcannabis.com' + path,
    headers=headers,
    params=params,
)
print(response.json())

// signRequest() is defined in the Request Signing guide:
// https://api.confidentcannabis.com/v0/docs/request-signing.md
import { signRequest } from './sign_request.js';

const API_KEY = 'YOUR_API_KEY';
const API_SECRET = 'YOUR_API_SECRET';
const path = "/v0/clients/orders";

const params = {
  // optional query params go here - they are signed too
};

const headers = { 'X-ConfidentLims-Timestamp': String(Math.floor(Date.now() / 1000)) };
headers['X-ConfidentLims-Signature'] = signRequest(
  "GET", path, headers, params, API_KEY, API_SECRET);
headers['X-ConfidentLims-APIKey'] = API_KEY;

const response = await fetch(`https://api.confidentcannabis.com${path}?${new URLSearchParams(params)}`, {
  headers,
});
console.log(await response.json());

{
  "success": true,
  "orders": [
    {
      "id": "2603CAL0142",
      "industry_id": 1,
      "industry_name": "Cannabis & Hemp",
      "lims_id": "CAL-2026-0142",
      "client_id": 4821,
      "status_id": 3,
      "status_name": "In Progress",
      "lab_license_number": "010-100254B7F",
      "client_license_number": "020-1003821A9C",
      "ordered_date": "2026-03-11T16:04:02",
      "verified_date": "2026-03-12T08:31:19",
      "completed_date": null,
      "last_modified": "2026-03-12T08:31:19"
    }
  ],
  "more_results": false
}