Harvest outputs report | Distru Documentation

One row per harvest assembly line: harvested material used, products made and costs.

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.
assemblyDatetime	object	No	Inclusive. YYYY-MM-DD (whole days, company timezone) or ISO 8601 with a UTC offset. Assembly creation date. Defaults to the last 7 days.
assemblyDatetime.end	string	No
assemblyDatetime.start	string	No
harvestName	string	No	Case-insensitive substring of an input harvest name.
locationId	string	No	Input location. Resolve via distru-search-locations.
outputProductCategoryId	string	No	Output product's category. Resolve via distru-search-lookups (type PRODUCT_CATEGORY).
outputProductName	string	No	Case-insensitive substring of an output product name.
status	enum `COMPLETEDPENDING`	No
strain	string	No	Case-insensitive substring of an input harvest strain.
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[].harvestAssemblyDate	string	Always
rows[].harvestAssemblyNumber	string	Always
rows[].status	enum `COMPLETEDPENDING`	Can be null
rows[].harvestName	string	Always
rows[].outputBatchNumber	string	Can be null
rows[].batchId	string	Can be null
rows[].outputPackageNumber	string	Can be null
rows[].packageId	string	Can be null
rows[].strain	string	Can be null
rows[].location	string	Always
rows[].locationId	string	Always
rows[].costInputOutput	string	Always
rows[].distruProduct	string	Can be null
rows[].productId	string	Can be null
rows[].productCategory	string	Can be null
rows[].quantity	string	Always
rows[].unitType	string	Can be null
rows[].unitCostActual	string	Can be null
rows[].unitCostDefault	string	Can be null
rows[].totalCostActual	string	Can be null
rows[].totalCostDefault	string	Can be null
rows[].costType	string	Can be null
rows[].costTypeDescription	string	Can be null
rows[].lineItemId	string	Always
rows[].outputReferenceId	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

Harvest assembly report: one row per line item of each harvest assembly created in the range: its inputs (harvested material used), outputs (products made, with batch and package numbers) and cost lines; costInputOutput says which. Use for harvest yields, harvest costs and what a harvest produced. For plant batch timelines use distru-report-plant-lifecycle; for individual cultivation events use distru-report-cultivation-transaction-history. Filters pick assemblies, not rows: an assembly matches when one input matches every input filter (harvestName, strain, locationId) and one output every output filter (outputProductName, outputProductCategoryId); then all its input, output and cost rows come back. lineItemId and outputReferenceId only link rows within one report run and are not IDs any other tool accepts; on a cost row, outputReferenceId is the lineItemId of the output the cost belongs to, which is how cost splits across several outputs. The six cost fields are null and left out of meta.columns when the caller cannot view costs. harvestAssemblyDate is MM/DD/YYYY in the caller's timezone; quantities 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.