Search unused Metrc tags | Distru Documentation

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	No	Omit for every license the caller can see; a tag is usable only under the license it was issued to. Resolve via distru-search-licenses.
search	string	No	Part of a tag. Everything outside A-F and 0-9 is stripped first, so pass upper case — lower-case letters are dropped. A full 24-char label matches that tag exactly.
tags	string[]	No	Exact full labels. A label missing from results is not this company's or already used — answers "can I still use these?".
kind	enum `PACKAGEPLANT`	No	Tag pool; PACKAGE and PLANT pools never overlap. Default: `"PACKAGE"`
sortBy	object	No	Default: most recently updated first.
sortBy.direction	enum `ASCDESC`	Yes
sortBy.field	enum `INSERTED_ATTAGUPDATED_AT`	Yes	INSERTED_AT/UPDATED_AT = tag row entered/last changed in Distru, not state-side dates.

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[].tag	string	Always
items[].license	object	Always
items[].license.id	string	Always
items[].license.licenseNumber	string	Always

What the AI reads

Searches the unused Metrc tags the state issued to the company — the physical track-and-trace labels still free to put on something, not the packages already wearing one. Distru never mints a tag: completing an assembly output takes one from this pool, so use this to find a valid metrcLabel. Tags already assigned to a package or plant are never returned, so every row is safe to use. For the packages themselves use distru-search-packages.