APIHarvest

Get harvests

GET
/public/v1/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.

Authorization

Bearer
headerAuthorizationBearer <token>

API token generated in Distru (Settings → Distru API). Send it on every request as Authorization: Bearer YOUR_API_TOKEN.

Query Parameters

finished_date?string

Return 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?boolean

true returns only harvests with a remaining_weight above zero; false returns only harvests with none left. Omit to return both.

harvested_datetime?string

Return 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?string

Return 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?string

Return only harvests whose name contains this text (case-insensitive substring match). Send a single value, not a list.

page?string

Page 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?string

Return 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.

Response Body

A list of harvests

*/*
  1. response

A collection of harvests

data?array<>

Harvests

next_page?string

URL for the next page of results; null when there is no next page

Example Request
curl -X GET 'https://app.distru.com/public/v1/harvests'
Example Response
{  "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}