Get harvests
Returns the paginated list of your own company's harvests, oldest first (ascending creation date). A harvest is a lot of cannabis harvested from plants, tracked from drying through packaging until it is finished. Each harvest reports its status, its license and location, the strain Metrc has on record, when it was submitted to Metrc, its wet_weight, and the remaining_weight that is still available to be packaged.
Read-only: this endpoint changes nothing in Distru or in Metrc. Harvests that are still being prepared for a teardown and harvests that have been removed are not listed.
Filter the result set by ids, license_ids, location_ids, metrc_ids, metrc_strain_ids, metrc_strain_names, statuses, name, has_remaining_weight, harvested_datetime, finished_date, inserted_datetime and updated_datetime; when several are supplied a harvest must satisfy all of them to be returned (AND). Results are scoped to your own company; you never see another tenant's harvests.
Results are paginated: read the top-level next_page URL to fetch the following page, and stop when it is null. Page size is fixed by the server and is not client-controllable.
This endpoint returns eventually consistent data, with changes taking up to 1 second to propagate in responses.
Required permission: harvests_permissions_view.
BearerAuthorizationBearer <token>API token generated in Distru (Settings → Distru API). Send it on every request as Authorization: Bearer YOUR_API_TOKEN.
finished_date?stringReturn only harvests marked finished within this range, as two comma-separated YYYY-MM-DD dates after,before, both inclusive. Either side may be left empty for an open-ended range; both empty is rejected. Harvests that are not finished never match.
has_remaining_weight?booleantrue returns only harvests with a remaining_weight above zero; false returns only harvests with none left. Omit to return both.
harvested_datetime?stringReturn only harvests harvested within this range, as two comma-separated ISO 8601 datetimes min,max. Either side may be left empty for an open-ended range. Harvests with no harvest datetime never match.
ids[]?array<string>Restrict the result to specific harvests by ID (the same ID returned as each harvest's id). Repeat the bracketed key once per ID. An empty list is treated as no filter. At most 200 IDs may be given.
inserted_datetime?stringReturn only harvests created within this range, as two comma-separated ISO 8601 datetimes min,max. Either side may be left empty for an open-ended range.
license_ids[]?array<string>Return only harvests under these licenses, by license ID. Repeat the bracketed key once per ID. Unknown IDs simply match nothing. At most 200 IDs may be given.
location_ids[]?array<string>Return only harvests stored at these locations, by location ID. Repeat the bracketed key once per ID. Harvests with no location never match. Unknown IDs simply match nothing. At most 200 IDs may be given.
metrc_ids[]?array<integer>Return only harvests with these Metrc harvest IDs (Metrc's integer IDs, the same as each harvest's metrc_id). Repeat the bracketed key once per ID. Harvests not synced with Metrc never match. At most 200 IDs may be given.
metrc_strain_ids[]?array<integer>Return only harvests whose Metrc strain has one of these Metrc integer IDs (each harvest's metrc_strain.id). Repeat the bracketed key once per ID. At most 200 IDs may be given.
metrc_strain_names[]?array<string>Return only harvests whose Metrc strain name (metrc_strain.name) equals one of these names. Each name must match in full, ignoring case. Repeat the bracketed key once per name. At most 200 names may be given.
name?stringReturn only harvests whose name contains this text (case-insensitive substring match). Send a single value, not a list.
page?stringPage selector. Page size is fixed by the server; paginate by following the next_page URL in each response rather than building page selectors yourself — it is null on the last page. next_page uses page[after]=<cursor>, an opaque token marking where the next page resumes; pass it back exactly as given, and only to the endpoint that issued it. This is seek-based, so every page stays fast no matter how deep you page.
statuses[]?array<>Return only harvests in one of these statuses; a harvest matches if it has any of them. Repeat the bracketed key once per status. At most 200 values may be given. See the status field of the harvest for what each value means.
updated_datetime?stringReturn only harvests last updated within this range, as two comma-separated ISO 8601 datetimes min,max. Either side may be left empty for an open-ended range.
A list of harvests
*/*- response
A collection of harvests
data?array<>Harvests
next_page?stringURL for the next page of results; null when there is no next page
curl -X GET 'https://app.distru.com/public/v1/harvests'{ "data": [ { "finished_date": null, "harvested_datetime": "2026-01-01T10:00:00.000000Z", "id": "ad72ee1c-04cb-4980-969e-c382f25ceadd", "inserted_datetime": "2026-11-16T13:02:07.957007Z", "license": { "active": true, "expiry_datetime": "2026-12-16T13:02:07.892107Z", "id": "00000000-0000-0000-0000-000000005ca6", "inserted_datetime": "2026-11-16T13:02:07.892240Z", "issue_datetime": "2026-11-16T13:02:07.892103Z", "license_number": "CDPH-00000117", "license_type": "Medium Indoor" }, "location": { "address": "123 Fake Street, Beverly Hills, CA 90210, US", "company_id": "00000000-0000-0000-0000-0000000247c9", "id": "00000000-0000-0000-0000-00000000e706", "license_id": "00000000-0000-0000-0000-000000005ca6", "name": "Dry Room" }, "metrc_id": 4321, "metrc_strain": { "id": 77, "name": "Blue Dream Strain" }, "name": "Blue Dream", "remaining_weight": "7.5", "status": "DRYING", "submitted_to_metrc_datetime": "2026-01-02T03:04:05.000000Z", "unit_type": { "id": "00000000-0000-0000-0000-0000001df774", "name": "Custom Unit" }, "updated_datetime": "2026-11-16T13:02:07.957007Z", "wet_weight": "107.5" } ], "next_page": null}