Search Metrc packages | Distru Documentation

Searches the packages Metrc holds for one license, as Distru last synced them, whether or not they are in Distru inventory.

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 the label.
labels	string[]	No	Exact full labels, ignoring case.
metrcIds	integer[]	No
statuses	enum[] `ACTIVEONHOLDFINISHEDDISCONTINUEDTRANSFERRED`	No	Default ACTIVE and ONHOLD. ONHOLD = failed lab testing, pending remediation; TRANSFERRED = transferred out to another license.
importStatus	enum `IMPORTABLEUNIMPORTEDIMPORTED`	No	IMPORTED = imported into Distru; UNIMPORTED = not in Distru and not ignored for import; IMPORTABLE = UNIMPORTED, active or on hold, with quantity left.
searchMetrcItem	string	No	Case-insensitive substring of the Metrc item name.
searchMetrcStrain	string	No	Case-insensitive substring of the strain name.
searchMetrcCategory	string	No	Case-insensitive substring of the Metrc item category.
metrcLocationIds	string[]	No	Metrc location IDs. Resolve via distru-search-metrc-locations.
labTestingStates	string[]	No	Exact Metrc lab testing states, e.g. TestPassed, TestFailed, NotSubmitted.
isTestingSample	boolean	No
isTradeSample	boolean	No
isFinishedGood	boolean	No
sortBy	object	No	Default: most recently modified in Metrc first.
sortBy.direction	enum `ASCDESC`	Yes
sortBy.field	enum `INSERTED_ATUPDATED_ATLABEL`	Yes	INSERTED_AT = created in Metrc; UPDATED_AT = last modified in Metrc.

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[].metrcId	number	Always
items[].label	string	Always
items[].status	enum `ACTIVEDISCONTINUEDFINISHEDINACTIVEONHOLDTRANSFERRED`	Always
items[].quantity	string	Always
items[].unitType	object	Can be null
items[].unitType.id	string	Always
items[].unitType.name	string	Always
items[].metrcItem	object	Always
items[].metrcItem.id	string	Always
items[].metrcItem.name	string	Always
items[].metrcItem.category	string	Can be null
items[].strainName	string	Can be null
items[].metrcLocation	object	Can be null
items[].metrcLocation.id	string	Always
items[].metrcLocation.name	string	Can be null
items[].labTestingState	string	Can be null
items[].labTestingStateDate	string	Can be null
items[].productionBatchNumber	string	Can be null
items[].packagedDate	string	Can be null
items[].expirationDate	string	Can be null
items[].finishedDate	string	Can be null
items[].archivedDate	string	Can be null
items[].note	string	Can be null
items[].sourcePackageLabels	string[]	Always
items[].sourceHarvestNames	string[]	Always
items[].receivedFromManifestNumber	string	Can be null
items[].receivedFromLicenseNumber	string	Can be null
items[].isTestingSample	boolean	Always
items[].isTradeSample	boolean	Always
items[].isProductionBatch	boolean	Always
items[].isFinishedGood	boolean	Always
items[].lastModifiedDatetime	string	Can be null
items[].package	object	Can be null
items[].package.id	string	Always
items[].package.metrcLabel	string	Always
items[].package.product	object	Always
items[].package.product.id	string	Always
items[].package.product.name	string	Always
items[].productMostRecentlyMappedToMetrcItem	object	Can be null
items[].productMostRecentlyMappedToMetrcItem.id	string	Always
items[].productMostRecentlyMappedToMetrcItem.name	string	Always

What the AI reads

Searches the packages Metrc holds for one license, as Distru last synced them, whether or not they are in Distru inventory. To bring packages into Distru, use distru-import-metrc-packages; for packages already in inventory, use distru-search-packages. package is the Distru package it was imported as, null when not imported. quantity is Metrc's, in unitType: the Distru unit matching Metrc's unit of measure, null when the company has none. productMostRecentlyMappedToMetrcItem is the product the package's Metrc item was last mapped to on this license, the likely product to import it as; null when never mapped or that product is inactive, deleted or hidden from you.