APIBatch
Get a batch
GET
Fetch one batch by its Distru batch ID, including its cost and on-hand quantity totals, custom field values, primary test result, and (when your company has bin tracking enabled) its bins. Returns 404 if no batch with that id exists in your company, and 403 if the authenticated user cannot access it under their team restrictions.
Required permission: products_permissions_view.
Bearerheader
AuthorizationBearer <token>API token generated in Distru (Settings → Distru API). Send it on every request as Authorization: Bearer YOUR_API_TOKEN.
id*stringThe Distru batch ID to fetch.
A single batch
*/*- response
A single batch
data?A lot of a product with all its details — a group of inventory sharing a harvest/production run, expiration date, potency, lab results, and cost. Used for batch-tracked products.
curl -X GET 'https://app.distru.com/public/v1/batches/00000000-0000-0000-0000-00000000011b'Example Response
{ "data": { "batch_number": "B001", "cbd": null, "creator": { "banned": false, "deleted_at": null, "email": "[email protected]", "full_name": "FirstName8072 LastName8073", "id": "00000000-0000-0000-0000-000000000f93", "inserted_datetime": "2026-10-13T15:03:35.548319Z", "role": { "id": "00000000-0000-0000-0000-00000000102c", "name": "Admin 4139" }, "updated_datetime": "2026-10-13T15:03:35.548319Z" }, "custom_data": [ { "id": 100, "name": "Custom Field 74", "value": "Custom Data 1" } ], "deleted_at": null, "description": "Test batch", "expiration_date": null, "expiration_datetime": null, "harvest_datetime": null, "id": "00000000-0000-0000-0000-000000000267", "inserted_datetime": "2026-10-13T15:03:35.554911Z", "manufactured_datetime": "2026-10-13T15:03:35.504216Z", "name": "B1922", "owner_id": "00000000-0000-0000-0000-000000000f96", "primary_test_result": null, "product": { "id": "3696aced-fb47-4651-a664-f0b30bb86533", "name": "Product 1917", "sku": "sku 1918", "updated_datetime": "2026-10-13T15:03:35.541287Z" }, "product_id": "3696aced-fb47-4651-a664-f0b30bb86533", "quantity_active": "0", "quantity_active_by_location": [], "tasks": [], "thc": null, "updated_datetime": "2026-10-13T15:03:35.554911Z" }}