APIPurchase
Get a purchase
GET
Get a single purchase by its ID, returned as the full purchase shape (line items, charges, active payments, and custom data). Drafts are returned too, with status DRAFT. Purchases outside your company are not found (404).
Required permission: purchases_permissions_view, plus access to the purchase under the authenticated user's team restrictions.
Bearerheader
AuthorizationBearer <token>API token generated in Distru (Settings → Distru API). Send it on every request as Authorization: Bearer YOUR_API_TOKEN.
id*stringPurchase ID
A single purchase
*/*- response
A single purchase order envelope
data?An order to buy inventory from a vendor. Holds the line items being bought, their quantities and prices, any extra charges, and the payments made against it. Receiving against it brings the inventory in.
curl -X GET 'https://app.distru.com/public/v1/purchases/00000000-0000-0000-0000-000000000084'Example Response
{ "data": { "billing_location": { "address": "123 Fake Street, Beverly Hills, CA 90210, US", "company_id": "00000000-0000-0000-0000-000000000fe2", "id": "00000000-0000-0000-0000-00000000050e", "license_id": null, "license_number": null, "name": "Place 1287" }, "biotrack_id": null, "charges": [ { "charge_preset": null, "id": "c162afda-b4cb-4572-a973-d7803935bdc6", "inserted_datetime": "2026-10-13T15:03:49.382138Z", "name": "C1", "percent": "10.0000", "price": "1.00", "tax": { "id": "00000000-0000-0000-0000-00000000001d", "name": "T1" }, "type": "CHARGE", "unit_type": "PERCENT" } ], "company": { "id": "00000000-0000-0000-0000-0000000008f5", "name": "Company 4063", "updated_datetime": "2026-10-13T15:03:49.312916Z" }, "creator": { "banned": false, "deleted_at": null, "email": "[email protected]", "full_name": "FirstName12056 LastName12057", "id": "00000000-0000-0000-0000-00000000176d", "inserted_datetime": "2026-10-13T15:03:49.340825Z", "role": { "id": "00000000-0000-0000-0000-0000000017e7", "name": "Admin 6118" }, "updated_datetime": "2026-10-13T15:03:49.340825Z" }, "custom_data": [ { "id": 123, "name": "Custom Field 97", "value": "Custom Field Value 1" } ], "description": null, "due_datetime": "2026-10-13T15:03:49.343273Z", "id": "00000000-0000-0000-0000-00000000009c", "inserted_datetime": "2026-10-13T15:03:49.343770Z", "items": [ { "batch": { "batch_number": null, "id": "00000000-0000-0000-0000-000000000555", "name": "B4295" }, "compliance_quantity": null, "id": "b8a3f580-8883-406b-a67a-95994b356e4a", "is_sample": false, "location": { "address": "123 Fake Street, Beverly Hills, CA 90210, US", "company_id": "00000000-0000-0000-0000-000000000fe2", "id": "00000000-0000-0000-0000-00000000050d", "license_id": null, "name": "Place 1286" }, "package": null, "price": "10.000000000", "price_base": "10", "product": { "id": "c3e5eabd-dc21-4d19-ac3d-e2d37f56eb21", "name": "Product 4287", "sku": "sku 4288", "updated_datetime": "2026-10-13T15:03:49.350289Z" }, "quantity": "15.000000000", "received_quantity": "0.000000000" }, { "batch": { "batch_number": null, "id": "00000000-0000-0000-0000-000000000556", "name": "B4296" }, "compliance_quantity": null, "id": "e7044abb-387e-48a4-bcac-5037abd5daf2", "is_sample": false, "location": { "address": "123 Fake Street, Beverly Hills, CA 90210, US", "company_id": "00000000-0000-0000-0000-000000000fe2", "id": "00000000-0000-0000-0000-00000000050d", "license_id": null, "name": "Place 1286" }, "package": null, "price": "10.000000000", "price_base": "10", "product": { "id": "a0903007-281c-43ed-a117-06eabe2adaa7", "name": "Product 4289", "sku": "sku 4290", "updated_datetime": "2026-10-13T15:03:49.356330Z" }, "quantity": "10.000000000", "received_quantity": "0.000000000" }, { "batch": { "batch_number": null, "id": "00000000-0000-0000-0000-000000000557", "name": "B4297" }, "compliance_quantity": null, "id": "a9ae8101-4ba3-4958-8e7e-d8aa6bcb3da7", "is_sample": false, "location": { "address": "123 Fake Street, Beverly Hills, CA 90210, US", "company_id": "00000000-0000-0000-0000-000000000fe2", "id": "00000000-0000-0000-0000-00000000050d", "license_id": null, "name": "Place 1286" }, "package": null, "price": "10.000000000", "price_base": "10", "product": { "id": "5fe5b57b-0707-4b9b-85ad-3235af96b3ba", "name": "Product 4291", "sku": "sku 4292", "updated_datetime": "2026-10-13T15:03:49.361529Z" }, "quantity": "5.000000000", "received_quantity": "0.000000000" }, { "batch": { "batch_number": null, "id": "00000000-0000-0000-0000-000000000558", "name": "B4298" }, "compliance_quantity": null, "id": "e9626645-ddc2-4037-a8f4-0c10b80eeaa4", "is_sample": false, "location": { "address": "123 Fake Street, Beverly Hills, CA 90210, US", "company_id": "00000000-0000-0000-0000-000000000fe2", "id": "00000000-0000-0000-0000-00000000050d", "license_id": null, "name": "Place 1286" }, "package": null, "price": "10.000000000", "price_base": "10", "product": { "id": "dcee4152-233e-46da-b01d-d555ab3e6547", "name": "Product 4293", "sku": "sku 4294", "updated_datetime": "2026-10-13T15:03:49.367478Z" }, "quantity": "2.000000000", "received_quantity": "0.000000000" } ], "location": { "address": "123 Fake Street, Beverly Hills, CA 90210, US", "company_id": "00000000-0000-0000-0000-000000000fe2", "id": "00000000-0000-0000-0000-00000000050d", "license_id": null, "license_number": null, "name": "Place 1286" }, "metrc_transfer_id": null, "order_datetime": "2026-10-13T15:03:49.343271Z", "owner": { "banned": false, "deleted_at": null, "email": "[email protected]", "full_name": "FirstName12056 LastName12057", "id": "00000000-0000-0000-0000-00000000176d", "inserted_datetime": "2026-10-13T15:03:49.340825Z", "role": { "id": "00000000-0000-0000-0000-0000000017e7", "name": "Admin 6118" }, "updated_datetime": "2026-10-13T15:03:49.340825Z" }, "paid": "100.01", "payment_status": "NOT_PAID", "payments": [ { "amount": "100.01", "company": { "id": "00000000-0000-0000-0000-0000000008f5", "name": "Company 4063", "updated_datetime": "2026-10-13T15:03:49.312916Z" }, "credit_uses": null, "description": "Payment for purchase", "fully_paid_with_credits": false, "id": "00000000-0000-0000-0000-000000000047", "inserted_datetime": "2026-10-13T15:03:49.391178Z", "invoice": null, "overpayment_credits": null, "payment_date": "2020-01-01T00:00:00.000000Z", "payment_datetime": "2020-01-01T00:00:00.000000Z", "payment_method": { "active": true, "deleted_at": null, "id": "00000000-0000-0000-0000-000000000059", "inserted_datetime": "2026-10-13T15:03:49.389843Z", "name": "Payment Method 88", "qb_payment_method_id": null, "type": "CREDIT_CARD", "updated_datetime": "2026-10-13T15:03:49.389843Z" }, "payment_number": "PYT-1", "payment_type": "PURCHASE", "purchase": { "id": "00000000-0000-0000-0000-00000000009c", "purchase_number": "Purchase #130", "status": "PENDING", "total": "32.00" }, "quickbooks_deposit_account_id": null, "status": "POSTED", "updated_datetime": "2026-10-13T15:03:49.391178Z" } ], "purchase_number": "Purchase #130", "qb_bill_id": null, "status": "PENDING", "supplier_location": null, "tasks": [], "total": "32.00", "updated_datetime": "2026-10-13T15:03:49.343770Z" }}