Search plant groups | Distru Documentation

Searches cultivation plant groups (plant batches) — a group of immature plants tracked as one unit until tagged.

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
licenseIds	string[]	No	Filter to plant groups under these licenses. Resolve via distru-search-licenses.
locationIds	string[]	No	Filter to plant groups at these locations. Resolve via distru-search-locations.
metrcStrainNames	string[]	No	Exact Metrc strain names. Matches any of them.
status	enum `ACTIVEANYINACTIVE`	No	ACTIVE: has immature plants. INACTIVE: none left. Default ACTIVE.
search	string	No	Case-insensitive substring match on the plant group name, Metrc strain name, or location name. Setting it also reorders results by how closely each field resembles the term; sortBy is ignored.
sortBy	object	No	Sort options. Defaults to most recently updated first when omitted. Ignored when search is set.
sortBy.direction	enum `ASCDESC`	Yes
sortBy.field	enum `NAMEPLANTED_ATINSERTED_ATUPDATED_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[].metrcStrainName	string	Can be null
items[].plantedAt	string	Always
items[].complianceType	enum `BIOTRACKMETRCNONE`	Can be null
items[].isActive	boolean	Always
items[].totalPlantsCount	number	Can be null
items[].immaturePlantsCount	number	Can be null
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 cultivation plant groups (plant batches) — a group of immature plants tracked as one unit until tagged. Step 1 of the lifecycle: plant group → plants (tagged; distru-search-plants with plantGroupId) → teardown → harvests. One row per group.