---
title: "Get Metrc items"
method: GET
path: "/public/v1/metrc/items"
tags: ["Metrc"]
---

# Get Metrc items

`GET /public/v1/metrc/items`

Get the Metrc items — the item definitions Distru caches from Metrc — across your licenses, filtered by various attributes. Results are ordered by Metrc's item id ascending and scoped to the company that owns the API key.

Each row mirrors an item as it exists in Metrc (name, product category, strain, unit of measure, quantity type), plus Distru's `unit_type` resolved by matching the item's Metrc unit of measure to one of your company's unit types by name (null when no unit type matches that name), and the owning `license`. Items deleted in Metrc are included by default — use `is_deleted` to return only live or only deleted items.

This is a read-only cache: it does not create, edit, or delete items in Metrc. Data is eventually consistent — changes synced from Metrc can take up to ~1 second to appear here.

## Query parameters

- `license_id` string
- `search` string
- `unit_type_category` 'COUNT' | 'VOLUME' | 'WEIGHT'
- `category_names` string[]
- `is_deleted` boolean
- `metrc_ids` integer[]
- `inserted_datetime` string
- `updated_datetime` string
- `page` string

## Response `200`

A list of Metrc items

## Other responses

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

---

[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)