List samples

get

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

Return the samples belonging to this lab, most recent order first.

Results are paged: walk them with start and limit (maximum 100 per page) and keep requesting pages while more_results is true.

The filters combine, so a polling integration can watch for work with status_id, and an incremental sync can pass the modified_since_time it recorded on its last successful run.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

start

integer

≥ 0

Defaults to 0

Zero-based index of the first sample to return.

limit

integer

0 to 100

Defaults to 100

Maximum number of samples to return, up to 100.

status_id

integer

0 to 100

Only return samples whose order is in this order status.

modified_since_time

string

Only return samples modified after this time.

client_id

integer

≥ 1

Only return samples belonging to this client.

regulator_batch_id

string

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

harvest_id

string

Only return samples from this harvest lot in 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.