Get a return
Fetch a single return by its Distru ID, including its line items, generated credits, associated sales order and invoice numbers, and the computed return quantities.
Returns 404 if no such return exists in your company, and 403 if the authenticated user cannot see it under their team restrictions. This endpoint is eventually consistent: a change can take up to 1 second to appear here.
Required permission: returns_permissions_view.
BearerAuthorizationBearer <token>API token generated in Distru (Settings → Distru API). Send it on every request as Authorization: Bearer YOUR_API_TOKEN.
id*stringDistru ID of the return — the same id string returned as id in a return response.
A single return
*/*- response
A single return envelope
data?Product a customer sent back, reversing the related inventory and financials. Usually tied to the original order, and may generate a credit for the customer.
curl -X GET 'https://app.distru.com/public/v1/returns/00000000-0000-0000-0000-000000000010'{ "data": { "company": { "id": "00000000-0000-0000-0000-00000000013c", "name": "Company 941", "updated_datetime": "2026-10-13T15:03:28.393795Z" }, "creator": { "banned": false, "deleted_at": null, "email": "[email protected]", "full_name": "FirstName2834 LastName2835", "id": "00000000-0000-0000-0000-000000000589", "inserted_datetime": "2026-10-13T15:03:28.345146Z", "role": { "id": "00000000-0000-0000-0000-0000000005b7", "name": "Admin 1462" }, "updated_datetime": "2026-10-13T15:03:28.345146Z" }, "credits": [ { "amount": "100", "credit_number": "CRT-RET", "id": "242d3714-23bb-400a-b517-b6fa1037e821", "source": "RETURN" } ], "custom_data": [], "description": null, "id": "00000000-0000-0000-0000-000000000022", "inserted_datetime": "2026-10-13T15:03:28.455205Z", "invoice_numbers": [ "INV-001", "INV-002" ], "items": [ { "id": "00000000-0000-0000-0000-000000000022", "order_item": { "batch": { "batch_number": null, "id": "00000000-0000-0000-0000-000000000097", "name": "B500" }, "compliance_quantity": null, "id": "c24ac4d6-39e4-4dc8-870d-4e404db21a36", "is_sample": false, "location": null, "package": null, "price": "10.000000000", "price_base": "10", "product": { "id": "7c30eeb6-ab5d-4b73-8cff-d9caa1b4936d", "name": "Product 496", "sku": "sku 497", "updated_datetime": "2026-10-13T15:03:28.379865Z" }, "quantity": "5.000000000" }, "quantity": 5, "waste": false } ], "location": { "address": "123 Fake Street, Beverly Hills, CA 90210, US", "company_id": "00000000-0000-0000-0000-000000000397", "id": "00000000-0000-0000-0000-000000000106", "license_id": null, "name": "Place 261" }, "order": { "id": "fe4dec3d-618b-4a2c-87bb-e082fd04cbab", "order_number": "SO-100", "status": "PROCESSING", "total": "0.00" }, "order_quantity": "5", "owner": { "banned": false, "deleted_at": null, "email": "[email protected]", "full_name": "FirstName2834 LastName2835", "id": "00000000-0000-0000-0000-000000000589", "inserted_datetime": "2026-10-13T15:03:28.345146Z", "role": { "id": "00000000-0000-0000-0000-0000000005b7", "name": "Admin 1462" }, "updated_datetime": "2026-10-13T15:03:28.345146Z" }, "qb_credit_memo_id": "QB-CM-1", "return_datetime": "2026-10-13T15:03:28.455008Z", "return_number": "RN-33", "return_quantity": "5", "return_type": "Full Return", "status": "PROCESSING", "tasks": [], "total": 32, "updated_datetime": "2026-10-13T15:03:28.455205Z" }}