APIOrder
Get an order
GET
Get a single order by ID, including its line items, charges, invoices, returns, delivery/fulfillment details, and custom field values — the same object returned in each entry of GET /public/v1/orders and in the upsert response. An ID that doesn't exist, or belongs to another company, returns a not-found error.
Note: this endpoint returns eventually consistent data — a write can take up to 1 second to be reflected here, so an order you just upserted may briefly read back with its previous values.
Required permission: orders_permissions_view. An order the authenticated user's team restrictions hide returns 403.
Bearerheader
AuthorizationBearer <token>API token generated in Distru (Settings → Distru API). Send it on every request as Authorization: Bearer YOUR_API_TOKEN.
id*stringOrder ID
A single order
*/*- response
A single order wrapped in a data envelope
data?A sale of products to a customer. Holds the line items sold, their quantities and prices, any extra charges/discounts/taxes, delivery and fulfillment details, and links to the resulting invoices and returns.
curl -X GET 'https://app.distru.com/public/v1/orders/18a6cda2-3440-4440-ac2d-842b0ffb06fb'Example Response
{ "data": { "billing_location": null, "biotrack_id": null, "blaze_payment_type": null, "buyer_company": null, "buyer_note": null, "charges": [ { "charge_preset": null, "id": "7844c58e-e8eb-4ef4-9b02-abe2c7fa771b", "inserted_datetime": "2026-10-13T15:04:00.120976Z", "name": "C1", "percent": "10.0000", "price": "1.00", "tax": { "id": "00000000-0000-0000-0000-000000000020", "name": "T1" }, "type": "CHARGE", "unit_type": "PERCENT" } ], "combined_order": null, "company": { "id": "00000000-0000-0000-0000-000000000a6a", "name": "Company 4509", "updated_datetime": "2026-10-13T15:04:00.008019Z" }, "creator": { "banned": false, "deleted_at": null, "email": "[email protected]", "full_name": "FirstName12978 LastName12979", "id": "00000000-0000-0000-0000-000000001941", "inserted_datetime": "2026-10-13T15:04:00.002534Z", "role": { "id": "00000000-0000-0000-0000-0000000019cc", "name": "Admin 6603" }, "updated_datetime": "2026-10-13T15:04:00.002534Z" }, "custom_data": [ { "id": 128, "name": "Custom Field 102", "value": "Custom Field Value 1" } ], "delivered_datetime": "2026-10-13T15:04:00.042179Z", "delivery_datetime": null, "due_datetime": "2026-10-13T15:04:00.042204Z", "external_notes": null, "id": "eff675b2-c977-47cc-a2b2-352af9cbe820", "inserted_datetime": "2026-10-13T15:04:00.042623Z", "internal_notes": null, "inventory_source": { "address": "123 Fake Street, Beverly Hills, CA 90210, US", "company_id": "00000000-0000-0000-0000-0000000011a0", "id": "00000000-0000-0000-0000-0000000005a8", "license_id": null, "license_number": null, "name": "Place 1440" }, "invoices": [], "items": [ { "batch": { "batch_number": null, "id": "00000000-0000-0000-0000-000000000668", "name": "B5116" }, "compliance_quantity": null, "cost_per_unit": null, "cost_per_unit_default": null, "id": "7a595cea-c2fd-47a0-a56b-70b73a13f3ce", "inserted_datetime": "2026-10-13T15:04:00.057238Z", "is_sample": false, "leaflink_id": null, "location": null, "note": null, "package": null, "price": "10.000000000", "price_base": "10", "price_tier_mode": "AUTO", "price_tier_version": null, "product": { "id": "676b56d3-69e1-4874-b90e-9fc47bb07b34", "name": "Product 5114", "sku": "sku 5115", "updated_datetime": "2026-10-13T15:04:00.054137Z" }, "quantity": "15.000000000", "returned_quantity": "0", "thc_percentage_total": null, "total_cost_actual": null, "total_cost_default": null }, { "batch": { "batch_number": null, "id": "00000000-0000-0000-0000-000000000669", "name": "B5119" }, "compliance_quantity": null, "cost_per_unit": null, "cost_per_unit_default": null, "id": "3f03e7f2-393e-481a-83c9-de49877fb821", "inserted_datetime": "2026-10-13T15:04:00.070427Z", "is_sample": false, "leaflink_id": null, "location": null, "note": null, "package": null, "price": "10.000000000", "price_base": "10", "price_tier_mode": "AUTO", "price_tier_version": null, "product": { "id": "34e75a59-d3c4-4363-b271-c8f8eaaf7914", "name": "Product 5117", "sku": "sku 5118", "updated_datetime": "2026-10-13T15:04:00.067732Z" }, "quantity": "10.000000000", "returned_quantity": "0", "thc_percentage_total": null, "total_cost_actual": null, "total_cost_default": null }, { "batch": { "batch_number": null, "id": "00000000-0000-0000-0000-00000000066a", "name": "B5122" }, "compliance_quantity": null, "cost_per_unit": null, "cost_per_unit_default": null, "id": "f87cdda6-bdde-436c-adb0-ffbe90096f6b", "inserted_datetime": "2026-10-13T15:04:00.082129Z", "is_sample": false, "leaflink_id": null, "location": null, "note": null, "package": null, "price": "10.000000000", "price_base": "10", "price_tier_mode": "AUTO", "price_tier_version": null, "product": { "id": "5415bd78-32c6-4381-b411-2f49dc23319b", "name": "Product 5120", "sku": "sku 5121", "updated_datetime": "2026-10-13T15:04:00.079453Z" }, "quantity": "5.000000000", "returned_quantity": "0", "thc_percentage_total": null, "total_cost_actual": null, "total_cost_default": null }, { "batch": { "batch_number": null, "id": "00000000-0000-0000-0000-00000000066b", "name": "B5125" }, "compliance_quantity": null, "cost_per_unit": null, "cost_per_unit_default": null, "id": "b4b16e0f-cff8-46d7-bebd-42fdc6947a9a", "inserted_datetime": "2026-10-13T15:04:00.093185Z", "is_sample": false, "leaflink_id": null, "location": null, "note": null, "package": null, "price": "10.000000000", "price_base": "10", "price_tier_mode": "AUTO", "price_tier_version": null, "product": { "id": "6a872ced-1442-4298-a673-ab37331105f3", "name": "Product 5123", "sku": "sku 5124", "updated_datetime": "2026-10-13T15:04:00.090617Z" }, "quantity": "2.000000000", "returned_quantity": "0", "thc_percentage_total": null, "total_cost_actual": null, "total_cost_default": null } ], "leaflink_id": null, "leaflink_order_number": null, "location": { "address": "123 Fake Street, Beverly Hills, CA 90210, US", "company_id": "00000000-0000-0000-0000-0000000011a0", "id": "00000000-0000-0000-0000-0000000005a8", "license_id": null, "license_number": null, "name": "Place 1440" }, "menu": null, "metrc_transfer_id": null, "metrc_transfer_template_error": null, "metrc_transfer_template_id": null, "metrc_transfer_template_status": null, "order_datetime": "2026-10-13T15:04:00.042204Z", "order_number": "SO-299", "owner": { "banned": false, "deleted_at": null, "email": "[email protected]", "full_name": "FirstName12978 LastName12979", "id": "00000000-0000-0000-0000-000000001941", "inserted_datetime": "2026-10-13T15:04:00.002534Z", "role": { "id": "00000000-0000-0000-0000-0000000019cc", "name": "Admin 6603" }, "updated_datetime": "2026-10-13T15:04:00.002534Z" }, "payment_term_name": null, "returns": [], "shipping_location": null, "status": "COMPLETED", "tasks": [], "total": "320.00", "updated_datetime": "2026-10-13T15:04:00.113827Z" }}