Search Metrc items | Distru Documentation

Searches the Metrc items of one license — the product definitions the state has accepted.

Inputs

Every tool also takes the common inputs.

Field	Type	Required	Description
limit	integer	No	Default: `10`
cursor	string	No	nextCursor of the previous call; keep the other arguments unchanged.
licenseId	string	Yes	Resolve via distru-search-licenses.
search	string	No	Case-insensitive substring of item name. Does not change sort order.
categoryNames	string[]	No	Exact, case-sensitive productCategoryName values. Resolve via distru-search-metrc-item-categories.
unitTypeCategory	enum `COUNTVOLUMEWEIGHT`	No	Match the output product's unit type so the assembly's compliance quantity is in a unit Metrc accepts.
sortBy	object	No	Default: most recently created first.
sortBy.direction	enum `ASCDESC`	Yes
sortBy.field	enum `INSERTED_ATNAME`	Yes	INSERTED_AT = created in Metrc; items whose state omits it sort last.

Output

Presence on a nested field assumes its parent exists.

Field	Type	Presence
hasMore	boolean	Always
nextCursor	string	Can be absent
totalCount	integer	Can be absent
items	object[]	Always
items[].id	string	Always
items[].name	string	Can be absent
items[].productCategoryName	string	Null or absent
items[].productCategoryType	string	Null or absent
items[].unitOfMeasureName	string	Null or absent
items[].quantityType	string	Null or absent
items[].strainName	string	Null or absent

What the AI reads

Searches the Metrc items of one license — the product definitions the state has accepted. Each row's id is the Metrc item ID an assembly output's metrcItemId expects; it is a Metrc value, not a Distru ID. Check the item's category, unit, quantity type and strain match the product it will be packaged as. Items Distru has queued but Metrc has not created yet are not in this list — use distru-search-pending-metrc-items for those. Deleted items are never returned.