InvoicesPayments and statements

List a customer's payments

GET
/v1/customers/{id}/payments

Newest first.

Authorization

apiKey
headerAuthorizationBearer <token>

An API key from the Developers page. rhq_test_ keys reach the sandbox, rhq_live_ keys the live side.

Path Parameters

id*string

Query Parameters

limit?integer

How many to return

Range1 <= value <= 100
Default25
cursor?string

nextCursor from the previous page

Response Body

Success

application/json
  1. response

Success

data*array<>
nextCursor*|

Pass as cursor for the next page. null on the last page

total*integer

How many match across every page

Range0 <= value
curl -X GET "https://example.com/v1/customers/cus_01K6XJ4Q8ZT3M9R5V2B7WDHNCA/payments"
{  "data": [    {      "id": "pmt_01K6XJ4Q8ZT3M9R5V2B7WDHNCA",      "number": "PMT-0001",      "customerId": "cus_01K6XJ4Q8ZT3M9R5V2B7WDHNCA",      "amount": 2878,      "currency": "USD",      "date": "2026-10-07T11:04:31.000Z",      "method": "bank_transfer",      "reference": null,      "allocations": [        {          "invoiceId": "inv_01K6XJ4Q8ZT3M9R5V2B7WDHNCA",          "invoiceNumber": "INV-0001",          "amount": 2878        }      ],      "unallocated": 2878,      "shared": true,      "issuer": {        "name": "Northwind Telecom",        "legalName": null,        "addressLines": [],        "taxId": null,        "billingEmail": null      },      "createdAt": "2026-10-07T11:04:31.000Z"    }  ],  "nextCursor": null,  "total": 1}