Get a license
Returns a single license by its ID, including the Metrc sync health objects described on the list endpoint: metrc_pull_status (freshness of the data Distru pulls from Metrc) and metrc_push_status (the queue of changes Distru pushes to Metrc). Both are null unless compliance_type is METRC. Also returns the license's intake_location — the default destination of POST /public/v1/packages/import — described on the list endpoint. Use this to resolve a license referenced elsewhere (for example the license_id on a location) into its full detail, or to poll one license's sync health.
Lookups are scoped to your own company: an ID that does not exist, or that belongs to another company, returns 404 — the two cases are indistinguishable.
This endpoint returns eventually consistent data, with changes taking up to 1 second to propagate in responses.
Required permission: licenses_permissions_view.
BearerAuthorizationBearer <token>API token generated in Distru (Settings → Distru API). Send it on every request as Authorization: Bearer YOUR_API_TOKEN.
id*stringThe license's Distru ID, as returned in the id field of a license response. License numbers and IDs from external systems such as Metrc are not accepted here.
A single license
*/*- response
A single license wrapped in a data envelope
data?A cannabis license held by your company, identifying it to the state and its compliance system. Extends the compact license nested in other resources with the health of the license's Metrc sync in both directions: metrc_pull_status for the data Distru pulls from Metrc, and metrc_push_status for the changes Distru pushes to Metrc. Returned only by the license endpoints.
curl -X GET 'https://app.distru.com/public/v1/licenses/00000000-0000-0000-0000-000000000011'{ "data": { "active": true, "compliance_type": "METRC", "expiry_datetime": "2026-11-08T09:10:08.529521Z", "id": "00000000-0000-0000-0000-00000000002b", "inserted_datetime": "2026-10-08T09:10:08.529603Z", "intake_location": null, "issue_datetime": "2026-10-08T09:10:08.529518Z", "license_number": "CDPH-00000045", "license_type": "Other", "metrc_pull_status": { "caches_updated_up_until": { "harvests": null, "items": "2026-09-01T11:00:00.000000Z", "locations": null, "packages": null, "plant_additives": null, "plant_batches": null, "plants": null, "processing_jobs": null, "sales_receipts": null, "strains": null, "transfers": null }, "has_in_progress_backfills": false }, "metrc_push_status": { "failed_count": 0, "last_completed_activity_datetime": null, "oldest_incomplete_activity": { "error": null, "error_count": 0, "error_type": null, "last_attempt_datetime": "2026-10-08T09:10:08.568051Z", "queued_datetime": "2026-10-08T09:10:08.568051Z", "status": "PENDING", "title": "T1", "type": "CREATE_ITEM" }, "queued_count": 1 }, "updated_datetime": "2026-10-08T09:10:08.529603Z" }}