Search harvests | 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.
ids	string[]	No
licenseId	string	No	Filter to harvests under this license. Resolve via distru-search-licenses.
locationIds	string[]	No	Filter to harvests at these locations. Resolve via distru-search-locations.
metrcStrainNames	string[]	No	Exact Metrc strain names. Matches any of them.
harvestedAfter	string	No	Harvested on or after. YYYY-MM-DD (start of day, company timezone) or ISO 8601 with a UTC offset.
harvestedBefore	string	No	Harvested on or before. YYYY-MM-DD (end of day, company timezone) or ISO 8601 with a UTC offset.
finishedAfter	string	No	Finished on or after. YYYY-MM-DD.
finishedBefore	string	No	Finished on or before. YYYY-MM-DD.
teardownId	string	No	Filter to harvests created from this teardown. Resolve via distru-search-teardowns.
search	string	No	Case-insensitive substring match on the harvest name. Ranks by name similarity after any explicit sortBy.
distruStatus	enum `DISCONTINUEDDRYINGFINISHEDON_HOLDPACKAGING`	No	Filter by the harvest lifecycle status.
excludeIds	string[]	No	Harvest IDs to leave out of the results.
sortBy	object	No	Sort options. Defaults to most recently updated first when omitted. With search, an explicit sortBy ranks first and name similarity breaks ties; without one, similarity alone ranks.
sortBy.direction	enum `ASCDESC`	Yes
sortBy.field	enum `NAMEHARVESTED_ATINSERTED_ATUPDATED_ATSUBMITTED_FOR_REVIEW_AT`	Yes	Field to sort by.

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	Always
items[].distruStatus	enum `DISCONTINUEDDRYINGFINISHEDON_HOLDPACKAGING`	Always
items[].harvestedAt	string	Can be null
items[].finishedDate	string	Can be null
items[].wetWeight	string	Always
items[].metrcStrain	object	Always
items[].metrcStrain.id	number	Can be null
items[].metrcStrain.name	string	Always
items[].unitType	object	Always
items[].unitType.id	string	Always
items[].unitType.name	string	Always
items[].license	object	Always
items[].license.id	string	Always
items[].license.licenseNumber	string	Always
items[].location	object	Can be null
items[].location.id	string	Always
items[].location.name	string	Always

What the AI reads

Searches cultivation harvests, the final lifecycle step: plant group → plants → teardown (distru-search-teardowns; submitting one creates harvests) → harvests. A harvest is the harvested plant material of one strain under one license. One row per harvest. wetWeight is in unitType. Never returns removed harvests or harvests in PREPARING status, even when filtered for by distruStatus.