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.

get/public/v1/licenses/{id}

Request

  • Base URL
    https://app.distru.com
  • Auth
    HTTP bearer

Path parameters

idstring required

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

Response

A single license

Example response

{
  "data": {
    "id": "02c88a3f-d759-4973-88f9-60049d682524",
    "intake_location": {
      "address": "1234 Warehouse Street, Oakland, CA",
      "company_id": "02c88a3f-d759-4973-88f9-60049d682524",
      "id": "02c88a3f-d759-4973-88f9-60049d682524",
      "license_id": "02c88a3f-d759-4973-88f9-60049d682524",
      "name": "Warehouse 1"
    },
    "license_number": "C11-1234567890"
  }
}

Changes