---
title: "Get a license"
method: GET
path: "/public/v1/licenses/{id}"
tags: ["License"]
---

# Get a license

`GET /public/v1/licenses/{id}`

Returns a single [license](#model-licensedetail) 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`. Use this to resolve a license referenced elsewhere (for example the `license_id` on a [location](#model-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`.

## Path parameters

- `id` string, required

## Response `200`

A single license

## Other responses

- `400` — Invalid parameters
- `401` — Missing or invalid API token
- `403` — The API token lacks the required permission
- `404` — Not Found

---

[API](https://skmtc.dev/distru/apis/distru-api.md) · [All operations](https://skmtc.dev/distru/apis/distru-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/distru/distru-api/revisions/eb775b7b6ee0/schema)