Plant lifecycle report | Distru Documentation

One row per plant batch: plants started, moved to veg, destroyed and harvested, with dates and costs per stage.

Inputs

Every tool also takes the common inputs.

Field	Type	Required	Description
cursor	string	No	nextCursor of the previous call; keep the other arguments unchanged.
batchCreationDatetime	object	No	Inclusive. YYYY-MM-DD (whole days, company timezone) or ISO 8601 with a UTC offset. Batch creation (planting) date. Defaults to the last 30 days.
batchCreationDatetime.end	string	No
batchCreationDatetime.start	string	No
strain	string	No	Case-insensitive substring of strain name.
maxRowsLimit	integer	No	Rows per page. Defaults to 500.

Output

Presence on a nested field assumes its parent exists.

Field	Type	Presence	Description
nextCursor	string	Can be absent	Pass as cursor to fetch the next page. Present only when meta.truncated.
meta	object	Always
meta.report	string	Always
meta.dateRange	string	Always
meta.rowLimit	number	Always
meta.offset	number	Always
meta.rowCount	number	Always
meta.totalRowCount	number	Always
meta.truncated	boolean	Always
meta.columns	object[]	Always
meta.columns[].key	string	Always
meta.columns[].label	string	Always
rows	object[]	Always
rows[].plantBatchName	string	Always
rows[].batchCreationDate	string	Always
rows[].strain	string	Always
rows[].plantsStarted	string	Always
rows[].plantsPromotedToVeg	string	Always
rows[].plantsDestroyed	string	Always
rows[].plantsHarvested	string	Always
rows[].promotedToVegDate	string	Can be null
rows[].firstHarvestDate	string	Can be null
rows[].lastHarvestDate	string	Can be null
rows[].daysAsBatch	string	Always
rows[].daysVegToLastHarvest	string	Can be null
rows[].totalLifecycleDays	string	Always
rows[].totalCostBatchStage	string	Can be null
rows[].totalCostVegToLastHarvest	string	Can be null
rows[].destroyedPlantCost	string	Can be null
rows[].totalLifecycleCost	string	Can be null
rows[].harvestNameS	string	Can be null
rows[].customFields	object[]	Always
rows[].customFields[].key	string	Always
rows[].customFields[].label	string	Always
rows[].customFields[].value	string	Can be null

What the AI reads

Plant batch lifecycle: one row per plant batch created in the range, with plants started, promoted to veg, destroyed and harvested, key dates, days per stage, cost per stage and the harvests it produced. Metrc only: just batches on active Metrc licenses whose facility tracks vegetative plants. Use for batch timelines, stage durations and cultivation cost per batch. For individual plant events use distru-report-cultivation-transaction-history; for harvest yields and costs use distru-report-harvest-outputs. The veg and harvest dates and daysVegToLastHarvest are null until the batch reaches that stage; daysAsBatch runs to today while the batch is not promoted. harvestNameS is null until a plant is harvested, and also when those harvests are not in Distru, even with harvest dates set. The four cost fields are null and left out of meta.columns when the caller cannot view costs; totalLifecycleCost is the sum of the other three. The dates are MM/DD/YYYY in the caller's timezone; counts, day spans and money are numeric strings. Returns 500 rows by default (maxRowsLimit, up to 5000). When meta.truncated is true more rows exist: repeat the call with the same filters, any date range made explicit so every page covers the same one, and cursor set to nextCursor — or narrow the filters when you need a summary rather than every row.