APIHarvest

Get a harvest

GET
/public/v1/harvests/{id}

Returns a single harvest by its ID, with the same fields as the list endpoint. Read-only: this endpoint changes nothing in Distru or in Metrc.

Lookups are scoped to your own company: an ID that does not exist, that belongs to another company, or that belongs to a removed or still-being-prepared harvest returns 404.

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.

Path Parameters

id*string

The harvest's Distru ID, as returned in the id field of a harvest response. Metrc harvest IDs are not accepted here. An ID that doesn't exist for your company returns 404.

Response Body

A single harvest

*/*
  1. response

A single harvest wrapped in a data envelope

data?

A lot of cannabis harvested from plants, tracked from drying through packaging until it is finished. Read-only.

Example Request
curl -X GET 'https://app.distru.com/public/v1/harvests/harv_683a48bb-4a06-4c13-8cf7-ca8460f1135b'
Example Response
{  "data": {    "finished_date": null,    "harvested_datetime": null,    "id": "26797941-6ffc-40da-a5c5-991cc3de67d9",    "inserted_datetime": "2026-11-16T13:02:09.459397Z",    "license": {      "active": true,      "expiry_datetime": "2026-12-16T13:02:09.450820Z",      "id": "00000000-0000-0000-0000-000000005cb6",      "inserted_datetime": "2026-11-16T13:02:09.450942Z",      "issue_datetime": "2026-11-16T13:02:09.450816Z",      "license_number": "CDPH-00000134",      "license_type": "Specialty Mixed-Light Tier 1"    },    "location": null,    "metrc_id": null,    "metrc_strain": null,    "name": "FooBar Harvest 30",    "remaining_weight": "5",    "status": "DRYING",    "submitted_to_metrc_datetime": null,    "unit_type": {      "id": "00000000-0000-0000-0000-0000001dfc3b",      "name": "Unit Type 68"    },    "updated_datetime": "2026-11-16T13:02:09.459397Z",    "wet_weight": "5"  }}