List samples

get

https://api.confidentcannabis.com/v0/clients/samples

Return every sample on your client's orders, ordered by order date descending and then by sample ID so the newest samples 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. Filters combine, so sending both status_id and harvest_id returns only samples matching both.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

start

integer

≥ 0

Defaults to 0

Zero-based offset of the first result.

limit

integer

0 to 100

Defaults to 100

Maximum results per page (max 100).

status_id

integer

0 to 100

Only return samples whose order is in this order status. See the order statuses endpoint for available IDs.

modified_since_time

string

Only return samples whose order was modified after this timestamp.

client_id

integer

≥ 1

Only return samples on orders for this client ID.

regulator_batch_id

string

Only return samples with this batch ID from the state's seed-to-sale tracking system.

harvest_id

string

Only return samples with this harvest lot ID from the state's seed-to-sale tracking system.

Headers

X-ConfidentCannabis-Signature

string

HMAC-SHA256 request signature. Required only when request signing is enabled for your API key — see the Request Signing guide.

X-ConfidentCannabis-Timestamp

string

Unix timestamp (seconds) of the request, required only when request signing is enabled for your API key. Requests older than 30 seconds are rejected.

Responses

200Success

400The request was malformed or failed validation. Validation failures include per-field messages in error_details. Possible error_code values: invalid_request, request_too_old.

401Authentication 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.

403The 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.