Get harvest assemblies
Returns the paginated list of your own company's harvest assemblies, oldest first (ascending creation date). A harvest assembly is a set of packages made from one Metrc harvest, either PENDING (tags and harvest weight reserved, no packages yet) or COMPLETED (packages created).
Read-only: this endpoint changes nothing in Distru or in Metrc. Removed harvest assemblies are not listed.
Filter the result set by ids, harvest_ids, statuses, inserted_datetime, updated_datetime and completion_datetime; when several are supplied a harvest assembly must satisfy all of them to be returned (AND). Results are scoped to your own company; you never see another tenant's harvest assemblies.
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.
completion_datetime?stringReturn only harvest assemblies completed within this range, as two comma-separated ISO 8601 datetimes min,max. Either side may be left empty for an open-ended range. Pending harvest assemblies never match.
harvest_ids[]?array<string>Return only harvest assemblies made from these harvests, by harvest ID. Repeat the bracketed key once per ID. Unknown IDs simply match nothing. At most 200 IDs may be given.
ids[]?array<string>Restrict the result to specific harvest assemblies by 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 harvest assemblies created within this range, as two comma-separated ISO 8601 datetimes min,max. Either side may be left empty for an open-ended range.
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 harvest assemblies in one of these statuses. Repeat the bracketed key once per status. See the status field of the harvest assembly for what each value means.
updated_datetime?stringReturn only harvest assemblies 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 harvest assemblies
*/*- response
A collection of harvest assemblies
data?array<>Harvest Assemblies
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/harvest-assemblies'{ "data": [ { "completion_datetime": null, "description": null, "harvest": { "id": "55f6e2ec-a0c0-451b-9f21-2bb21f213146", "metrc_id": null, "name": "Spring-Hill-Kush-#196-11/16/2026" }, "harvest_assembly_number": "HAS-0000001", "id": "cd5c0272-20d0-497e-b015-50e2d6ea4d3c", "inserted_datetime": "2026-11-16T13:02:12.735930Z", "outputs": [ { "batch_number": null, "costs": [], "expiration_date": null, "id": "4214a580-1b8f-4f0b-baaa-1a9a291e7a4e", "location": { "address": "123 Fake Street, Beverly Hills, CA 90210, US", "company_id": "00000000-0000-0000-0000-000000024902", "id": "00000000-0000-0000-0000-00000000e771", "license_id": "00000000-0000-0000-0000-000000005cd0", "name": "Place 392" }, "metrc_item_id": 1000033, "metrc_label": "1A4010200001234000000065", "metrc_notes": null, "metrc_production_batch_number": null, "metrc_quantity": "1", "metrc_unit_name": "Grams", "package": null, "package_date": "2026-11-16", "product": { "id": "4b2cc7e0-1ad3-4135-b3ae-844764642a27", "name": "Product 852", "sku": "sku 853", "updated_datetime": "2026-11-16T13:02:12.670590Z" }, "quantity": "1" } ], "status": "PENDING", "updated_datetime": "2026-11-16T13:02:12.735930Z" } ], "next_page": null}