APIPayment

Get a payment

GET
/public/v1/payments/{id}

Get a single payment by its ID.

The response carries the same shape as a list entry, plus quickbooks_deposit_account_name (the human-readable name of the QuickBooks Online deposit account, resolved only here — the list endpoint omits it). Like the list endpoint, at most one of invoice / purchase is populated depending on payment_type, and status is POSTED or VOIDED.

Returns 404 if no payment with that ID exists within your company; soft-deleted payments return 404 too. Voided payments are returned normally with status VOIDED. A payment on an invoice or purchase the authenticated user cannot view under their team restrictions is still returned; the records they cannot view are null or left out, as in the list.

Required permission: payments_permissions_view.

Authorization

Bearer
headerAuthorizationBearer <token>

API token generated in Distru (Settings → Distru API). Send it on every request as Authorization: Bearer YOUR_API_TOKEN.

Path Parameters

id*string

The payment's Distru ID, as returned in the id field of the list endpoint. An ID that doesn't exist for your company returns 404.

Response Body

A single payment

*/*
  1. response

A single Payment

data?

A record of money exchanged — received from a customer against an invoice, or paid to a vendor against a purchase order.

Example Request
curl -X GET 'https://app.distru.com/public/v1/payments/00000000-0000-0000-0000-000000000024'
Example Response
{  "data": {    "amount": "10",    "company": {      "id": "00000000-0000-0000-0000-0000000002a7",      "name": "Company 1557",      "updated_datetime": "2026-08-24T16:01:10.102256Z"    },    "credit_uses": [      {        "amount": "30",        "credit": {          "amount": "100",          "credit_number": "CRT-U",          "id": "bb27673b-26ca-463d-8327-8732c4436300",          "source": "USER"        },        "id": "b80c8e39-24cd-4efb-bac0-7af44efe55d3"      }    ],    "description": null,    "fully_paid_with_credits": false,    "id": "00000000-0000-0000-0000-000000000024",    "inserted_datetime": "2026-08-24T16:01:10.121777Z",    "invoice": {      "id": "00000000-0000-0000-0000-00000000002e",      "invoice_number": "Invoice #44",      "status": "NOT_PAID",      "total": "32.00"    },    "overpayment_credits": [      {        "amount": "20",        "credit_number": "CRT-OP",        "id": "cd953984-6275-4d8d-adf3-3e03f159709e",        "source": "INVOICE_PAYMENT"      }    ],    "payment_date": "2026-08-24T16:01:10.120520Z",    "payment_datetime": "2026-08-24T16:01:10.120520Z",    "payment_method": {      "active": true,      "deleted_at": null,      "id": "00000000-0000-0000-0000-000000000032",      "inserted_datetime": "2026-08-24T16:01:10.119863Z",      "name": "Payment Method 49",      "qb_payment_method_id": null,      "type": "CREDIT_CARD",      "updated_datetime": "2026-08-24T16:01:10.119863Z"    },    "payment_number": "Payment #34",    "payment_type": "INVOICE",    "purchase": null,    "quickbooks_deposit_account_id": null,    "quickbooks_deposit_account_name": null,    "status": "POSTED",    "updated_datetime": "2026-08-24T16:01:10.121777Z"  }}