Search Metrc sync history | 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.
assemblyIds	string[]	No	Resolve via distru-search-assemblies.
createdDateAfter	string	No	Inclusive. YYYY-MM-DD (start of day, company timezone) or ISO 8601 with a UTC offset.
createdDateBefore	string	No	Inclusive. YYYY-MM-DD (end of day, company timezone) or ISO 8601 with a UTC offset.
creatorIds	string[]	No	Resolve via distru-search-users.
ids	string[]	No
licenseIds	string[]	No	Resolve via distru-search-licenses.
packageIds	string[]	No	Activities acting on, creating (as assembly output), moving, or packaging plant batches into these packages. Resolve via distru-search-packages.
sortBy	object	No	Default INSERTED_AT DESC.
sortBy.direction	enum `ASCDESC`	Yes
sortBy.field	enum `INSERTED_AT`	Yes
statuses	enum[] `QUEUEDFAILEDCOMPLETED`	No

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[].type	enum 71 values `ADJUST_PACKAGEADJUST_PLANT_BATCHESADJUST_PROCESSING_JOBBIOTRACK_ACCEPT_INVOICE_PAYMENTBIOTRACK_ADJUST_INVENTORY_QUANTITYBIOTRACK_ADJUST_INVENTORY_USABLE_QUANTITYBIOTRACK_ARRIVE_MANIFEST_STOPBIOTRACK_ARRIVE_RETURN_MANIFEST_STOPBIOTRACK_CREATE_INVENTORYBIOTRACK_CREATE_ROOMBIOTRACK_CREATE_TEST_SAMPLE_INVENTORYBIOTRACK_CREATE_TRANSFERBIOTRACK_DELETE_DRIVERBIOTRACK_DELETE_INVOICE_PAYMENTBIOTRACK_DELETE_VEHICLEBIOTRACK_DESTROY_INVENTORYBIOTRACK_MODIFY_INVENTORYBIOTRACK_MOVE_INVENTORIESBIOTRACK_RECEIVE_RETURN_TRANSFERBIOTRACK_RECEIVE_TRANSFERBIOTRACK_RECLAIM_UNACCEPTED_MANIFEST_ITEMSBIOTRACK_REJECT_INVOICE_PAYMENTBIOTRACK_SPLIT_INVENTORIESBIOTRACK_UNDO_INVENTORY_CONVERSIONBIOTRACK_UPDATE_INVOICE_ITEM_PRICESBIOTRACK_UPDATE_PICKUP_MANIFEST_TRANSPORTBIOTRACK_UPDATE_ROOMBIOTRACK_UPDATE_TRANSFER_ITEM_PRICESBIOTRACK_UPSERT_DRIVERBIOTRACK_UPSERT_INVOICEBIOTRACK_UPSERT_INVOICE_PAYMENTBIOTRACK_UPSERT_MANIFESTBIOTRACK_UPSERT_USERBIOTRACK_UPSERT_VEHICLEBIOTRACK_VOID_INVOICEBIOTRACK_VOID_MANIFESTBIOTRACK_VOID_TRANSFERCHANGE_IS_FINISHED_GOODCHANGE_PACKAGE_LOCATIONCHANGE_PLANT_BATCH_GROWTH_PHASECHANGE_PLANT_BATCH_STRAINCHANGE_PLANT_GROWTH_PHASECREATE_HARVEST_PACKAGECREATE_ITEMCREATE_LOCATIONCREATE_PACKAGECREATE_PACKAGE_FROM_PROCESSING_JOBCREATE_PLANT_ADDITIVE_TEMPLATECREATE_PLANT_BATCHES_FROM_PACKAGECREATE_PLANT_BATCHES_FROM_PLANTCREATE_PROCESSING_JOBCREATE_PROCESSING_JOB_TYPECREATE_STRAINDELETE_PROCESSING_JOBDESTROY_PLANT_BATCHESDESTROY_PLANTSFINISH_HARVESTFINISH_PACKAGEFINISH_PROCESSING_JOBGENERATE_RETAIL_IDSHARVEST_PLANTSMETRC_CHANGE_IS_TRADE_SAMPLEMOVE_PLANT_BATCHESMOVE_PLANTSPACKAGE_PLANT_BATCHESRECORD_HARVEST_WASTERECORD_PLANT_ADDITIVERECORD_PLANT_WASTERENAME_PLANT_BATCHSPLIT_PLANT_BATCHESUNFINISH_PACKAGE`	Always
items[].title	string	Always
items[].description	string	Always
items[].status	enum `QUEUEDFAILEDCOMPLETED`	Always
items[].lastError	string	Can be null
items[].insertedAt	string	Always
items[].updatedAt	string	Always
items[].license	object	Always
items[].license.id	string	Always
items[].license.licenseNumber	string	Always
items[].creator	object	Always
items[].creator.id	string	Always
items[].creator.profile	object	Always
items[].creator.profile.fullName	string	Always
items[].package	object	Can be null
items[].package.id	string	Always
items[].package.metrcLabel	string	Always
items[].assembly	object	Can be null
items[].assembly.id	string	Always
items[].assembly.number	string	Always

What the AI reads

Searches Metrc activities — the changes Distru sends to Metrc. When a user makes a change in Distru that Metrc must also record (e.g. creating, adjusting or moving a package), Distru saves it and queues an activity that syncs in the background. Each license's activities sync one at a time, in creation order; a failed one holds back every later activity of its license until it is retried or undone, so a license has at most one FAILED activity at a time. Use it to find why a change isn't in Metrc yet, what is blocking a license's sync, or what is still queued. lastError is the latest error from sending it, null once it syncs. The package and assembly are null when there is none or the caller cannot see it.