Get Metrc items

Filter to items belonging to this license, given as a Distru license resource ID (as returned by the licenses endpoint — not a Metrc or state license number). Omit to return items across all of the company's licenses; a license ID that doesn't belong to your company simply returns no items.

Filter to items belonging to the Metrc license with this license number (exact match, not a substring). A convenience alternative to license_id; combining the two is a 400. Unlike license_id, an unknown value is rejected — if your company has no Metrc license with this number the request fails with a 400.

Filter to items whose Metrc name contains this value (case-insensitive substring match against the item's name).

Filter by the item's quantity category, matched against its Metrc quantity type: COUNT (count-based), VOLUME (volume-based), or WEIGHT (weight-based). Omit to return all categories.

Filter to items whose Metrc product category name exactly matches one of the given values — an item matches if its category_name equals any listed value (OR semantics). Case-sensitive: values must match the Metrc category name verbatim. An empty list is ignored (returns items unfiltered by this parameter).

Filter by whether the item is deleted in Metrc. true returns only deleted items; false returns only live items. Omit to return both.

Filter to items with these Metrc item identifiers — Metrc's own integer IDs (the id in the response), not Distru IDs. Matches an item if its Metrc ID equals any of the listed values (OR semantics). An empty list is ignored (returns items unfiltered by this parameter).

Filter by when Distru last fetched the item from Metrc (the fetched_datetime in the response). Accepts a comma-separated from,to range (ISO-8601 UTC); either side may be omitted, e.g. ,2022-07-10T00:00:00Z returns items last fetched on or before that time.

Page selector. Page size is fixed by the server; paginate by following the next_page URL in each response rather than building page selectors yourself — it is null on the last page. next_page uses page[after]=<cursor>, an opaque token marking where the next page resumes; pass it back exactly as given, and only to the endpoint that issued it. This is seek-based, so every page stays fast no matter how deep you page.