Search plants | 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
statuses	enum[] `DESTROYEDFLOWERINGHARVESTEDHARVESTINGIMMATUREPACKAGEDVEGETATIVE`	No	Filter by cultivation status. Matches any of the given statuses.
licenseId	string	No	Filter to plants under this license. Resolve via distru-search-licenses.
locationIds	string[]	No	Filter to plants at these locations. Resolve via distru-search-locations.
metrcStrainNames	string[]	No	Exact Metrc strain names. Matches any of them.
floweredAfter	string	No	Entered flowering on or after. YYYY-MM-DD (start of day, company timezone) or ISO 8601 with a UTC offset.
floweredBefore	string	No	Entered flowering on or before. YYYY-MM-DD (end of day, company timezone) or ISO 8601 with a UTC offset.
plantGroupId	string	No	Filter to plants from this plant group (batch). Resolve via distru-search-plant-groups.
harvestId	string	No	Filter to plants that went into this harvest. Resolve via distru-search-harvests.
teardownId	string	No	Filter to plants in this teardown. Resolve via distru-search-teardowns.
isMother	boolean	No
isWeighed	boolean	No
search	string	No	Case-insensitive substring match on the Metrc plant label.
sortBy	object	No	Sort options. Defaults to most recently updated first when omitted.
sortBy.direction	enum `ASCDESC`	Yes
sortBy.field	enum `PLANTED_ATUPDATED_ATINSERTED_ATLABEL`	Yes	Field to sort by. LABEL is the Metrc plant label.

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[].status	enum `DESTROYEDFLOWERINGHARVESTEDHARVESTINGIMMATUREPACKAGEDVEGETATIVE`	Always
items[].plantedAt	string	Always
items[].floweredAt	string	Can be null
items[].harvestedAt	string	Can be null
items[].destroyedAt	string	Can be null
items[].isMotherPlant	boolean	Always
items[].metrcLabel	string	Can be null
items[].metrcStrainName	string	Can be null
items[].metrcPlantBatchName	string	Can be null
items[].plantGroup	object	Can be null
items[].plantGroup.id	string	Always
items[].plantGroup.name	string	Always
items[].license	object	Always
items[].license.id	string	Always
items[].license.licenseNumber	string	Always
items[].location	object	Always
items[].location.id	string	Always
items[].location.name	string	Always

What the AI reads

Searches individual tagged cultivation plants. Step 2 of the lifecycle: plant group (distru-search-plant-groups) → plants → teardown (distru-search-teardowns) → harvests. One row per plant.