APIInvoice
Get an invoice
GET
Fetch a single invoice by its ID, including its line items, charges, non-voided payments, and custom field values. Read-only, with no side effects. Returns 404 when no invoice with that ID exists in the caller's company. Required permission: invoices_permissions_view. The authenticated user must also have access to the requested invoice under their team restrictions, otherwise the request is rejected even though the invoice exists.
Bearerheader
AuthorizationBearer <token>API token generated in Distru (Settings → Distru API). Send it on every request as Authorization: Bearer YOUR_API_TOKEN.
id*stringThe invoice's ID — the id returned by the list and show invoice endpoints.
An invoice
*/*- response
A single invoice wrapped in a data envelope
data?A bill to a customer for what they owe, tracking the total, how much has been paid, and what remains. Always generated from a sales order.
curl -X GET 'https://app.distru.com/public/v1/invoices/00000000-0000-0000-0000-00000000004d'Example Response
{ "data": { "billing_location": { "address": "123 Fake Street, Beverly Hills, CA 90210, US", "company_id": "00000000-0000-0000-0000-00000000108a", "id": "00000000-0000-0000-0000-000000000547", "license_id": "00000000-0000-0000-0000-0000000001c9", "license_number": "CDPH-00000480", "name": "Place 1344" }, "charges": [ { "charge_preset": null, "id": "a77c0f3e-ae3a-4acd-adb3-4e6549c9ceec", "inserted_datetime": "2026-10-13T15:03:51.227100Z", "name": "C1", "percent": "10.0000", "price": "1.00", "tax": { "id": "00000000-0000-0000-0000-00000000001e", "name": "T1" }, "type": "CHARGE", "unit_type": "PERCENT" } ], "company": { "id": "00000000-0000-0000-0000-000000000985", "name": "Company 4230", "updated_datetime": "2026-10-13T15:03:51.074433Z" }, "creator": { "banned": false, "deleted_at": null, "email": "[email protected]", "full_name": "FirstName12364 LastName12365", "id": "00000000-0000-0000-0000-00000000180b", "inserted_datetime": "2026-10-13T15:03:51.052974Z", "role": { "id": "00000000-0000-0000-0000-00000000188b", "name": "Admin 6282" }, "updated_datetime": "2026-10-13T15:03:51.052974Z" }, "custom_data": [], "due_datetime": "2026-10-13T15:03:51.158080Z", "external_notes": null, "id": "00000000-0000-0000-0000-00000000009f", "inserted_datetime": "2026-10-13T15:03:51.158707Z", "internal_notes": null, "invoice_datetime": "2026-10-13T15:03:51.158068Z", "invoice_number": "Invoice #147", "items": [ { "batch": { "batch_number": null, "id": "00000000-0000-0000-0000-0000000005c1", "name": "B4617" }, "cost_per_unit": null, "cost_per_unit_default": null, "description": null, "id": "00000000-0000-0000-0000-00000000009a", "inserted_datetime": "2026-10-13T15:03:51.161647Z", "order_item": { "batch": { "batch_number": null, "id": "00000000-0000-0000-0000-0000000005c1", "name": "B4617" }, "compliance_quantity": null, "cost_per_unit": null, "cost_per_unit_default": null, "id": "c79afd3c-e29d-4be4-843b-c3895d3d8bf0", "inserted_datetime": "2026-10-13T15:03:51.087595Z", "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": "21928c2b-104a-4a60-a8cc-9d81fee36e90", "name": "Product 4615", "sku": "sku 4616", "updated_datetime": "2026-10-13T15:03:51.084492Z" }, "quantity": "15.000000000", "returned_quantity": "0", "thc_percentage_total": null, "total_cost_actual": null, "total_cost_default": null }, "order_item_id": "c79afd3c-e29d-4be4-843b-c3895d3d8bf0", "package": null, "price": "10.000000000", "product": { "id": "21928c2b-104a-4a60-a8cc-9d81fee36e90", "name": "Product 4615", "sku": "sku 4616", "updated_datetime": "2026-10-13T15:03:51.084492Z" }, "quantity": "10.000000000", "returned_quantity": "0", "total_cost_actual": null, "total_cost_default": null }, { "batch": { "batch_number": null, "id": "00000000-0000-0000-0000-0000000005c3", "name": "B4623" }, "cost_per_unit": null, "cost_per_unit_default": null, "description": null, "id": "00000000-0000-0000-0000-00000000009b", "inserted_datetime": "2026-10-13T15:03:51.163560Z", "order_item": { "batch": { "batch_number": null, "id": "00000000-0000-0000-0000-0000000005c3", "name": "B4623" }, "compliance_quantity": null, "cost_per_unit": null, "cost_per_unit_default": null, "id": "56d6961b-90e5-4d39-bd9c-e18e19216c2c", "inserted_datetime": "2026-10-13T15:03:51.101248Z", "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": "60735a7e-f819-4bee-8a22-0f31d3e23827", "name": "Product 4621", "sku": "sku 4622", "updated_datetime": "2026-10-13T15:03:51.098438Z" }, "quantity": "10.000000000", "returned_quantity": "0", "thc_percentage_total": null, "total_cost_actual": null, "total_cost_default": null }, "order_item_id": "56d6961b-90e5-4d39-bd9c-e18e19216c2c", "package": null, "price": "10.000000000", "product": { "id": "60735a7e-f819-4bee-8a22-0f31d3e23827", "name": "Product 4621", "sku": "sku 4622", "updated_datetime": "2026-10-13T15:03:51.098438Z" }, "quantity": "10.000000000", "returned_quantity": "0", "total_cost_actual": null, "total_cost_default": null } ], "order": { "id": "9bee89c8-3fc6-4fb8-a9e9-c42bf1988bf5", "order_number": "SO-247", "status": "PENDING", "total": "320.00" }, "owner": { "banned": false, "deleted_at": null, "email": "[email protected]", "full_name": "FirstName12364 LastName12365", "id": "00000000-0000-0000-0000-00000000180b", "inserted_datetime": "2026-10-13T15:03:51.052974Z", "role": { "id": "00000000-0000-0000-0000-00000000188b", "name": "Admin 6282" }, "updated_datetime": "2026-10-13T15:03:51.052974Z" }, "paid_amount": "5", "payment_term_name": null, "payments": [ { "amount": "5", "company": { "id": "00000000-0000-0000-0000-000000000985", "name": "Company 4230", "updated_datetime": "2026-10-13T15:03:51.074433Z" }, "credit_uses": [], "description": null, "fully_paid_with_credits": false, "id": "00000000-0000-0000-0000-000000000049", "inserted_datetime": "2026-10-13T15:03:51.181671Z", "invoice": { "id": "00000000-0000-0000-0000-00000000009f", "invoice_number": "Invoice #147", "status": "PARTIALLY_PAID", "total": "200.00" }, "overpayment_credits": [], "payment_date": "2026-10-13T15:03:51.171651Z", "payment_datetime": "2026-10-13T15:03:51.171651Z", "payment_method": { "active": true, "deleted_at": null, "id": "00000000-0000-0000-0000-00000000005b", "inserted_datetime": "2026-10-13T15:03:51.171008Z", "name": "Payment Method 90", "qb_payment_method_id": null, "type": "CREDIT_CARD", "updated_datetime": "2026-10-13T15:03:51.171008Z" }, "payment_number": "PYT-0000001", "payment_type": "INVOICE", "purchase": null, "quickbooks_deposit_account_id": null, "status": "POSTED", "updated_datetime": "2026-10-13T15:03:51.181671Z" } ], "remaining_amount": "195.00", "status": "PARTIALLY_PAID", "tasks": [], "total": "200.00", "updated_datetime": "2026-10-13T15:03:51.185987Z", "voided_datetime": null }}