Cultivation transaction history | Distru Documentation

Every cultivation event in a date range, from plant batch creation to harvest, waste and packaging.

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.
licenseIds	string[]	No	Resolve via distru-search-licenses.
strain	string	No	Exact, case-sensitive strain name. Narrows per-plant rows only: teardown output, waste, packaging and additive rows still come back, so pair it with transactionTypes when that matters.
transactionDatetime	object	No	Inclusive. YYYY-MM-DD (whole days, company timezone) or ISO 8601 with a UTC offset. Defaults to the last 30 days.
transactionDatetime.end	string	No
transactionDatetime.start	string	No
transactionTypes	enum[] `PLANT_BATCH_CREATIONPLANT_BATCH_ADJUSTMENTSPLIT_PLANT_BATCHDESTROY_PLANTMOVE_PLANTSGROWTH_PHASE_CHANGEADDITIVE_APPLICATIONPACKAGE_PLANT_BATCHPLANT_ADDED_TO_TEARDOWNHARVEST_CREATED_FROM_TEARDOWNRECORD_WASTE_HARVESTCREATE_PACKAGE_FROM_HARVEST`	No	GROWTH_PHASE_CHANGE selects every phase transition.
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[].date	string	Always
rows[].strain	string	Can be null
rows[].batchName	string	Can be null
rows[].plantTagS	string	Can be null
rows[].productName	string	Can be null
rows[].productId	string	Can be null
rows[].packageLabelS	string	Can be null
rows[].type	string	Always
rows[].relatedEntity	string	Can be null
rows[].relatedEntityStatus	string	Can be null
rows[].amount	string	Always
rows[].unit	string	Can be null
rows[].description	string	Can be null
rows[].totalCost	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

Cultivation event log: one row per cultivation transaction in the range, across the plant lifecycle from plant batch creation to harvest, waste and packaging, with strain, plant batch, plant tags, packages, the related teardown or harvest and its status, and signed amount. Newest first. Use to trace what happened to plants or plant batches over time, not for a batch's current plant count. For one summary row per plant batch use distru-report-plant-lifecycle; for harvest yields and costs use distru-report-harvest-outputs. Plants of one batch moved, promoted, destroyed or added to a teardown in one operation come back as one row: amount counts them and plantTagS lists their tags. type is a display string that can carry the transition (e.g. "Growth Phase Change (Immature → Vegetative)"), so match it by prefix, not against the transactionTypes values. amount is negative where plants or stock left. strain and batchName are null on rows with no plant batch behind them (teardown, harvest and waste rows). totalCost is null and left out of meta.columns when the caller cannot view costs, and null on teardown input and output rows. date is MM/DD/YYYY in the caller's timezone; amount and totalCost 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.