Get a customer's statement

GET
/v1/customers/{id}/statement

Opening balance, every invoice, credit note, payment and refund in the date range, and the closing balance: one row set for each currency this customer has been billed, paid or refunded in. GET /customers/{id}/statement.csv with the same query returns the same rows as CSV.

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

from*string

The start of the statement, inclusive

Formatdate-time
to*string

The end of the statement, inclusive

Formatdate-time

Response Body

Success

application/json
  1. response

Success

data*array<>
curl -X GET "https://example.com/v1/customers/cus_01K6XJ4Q8ZT3M9R5V2B7WDHNCA/statement?from=2026-10-07T11%3A04%3A31.000Z&to=2026-10-07T11%3A04%3A31.000Z"
{  "data": [    {      "currency": "USD",      "opening": 2878,      "rows": [        {          "date": "2026-10-07T11:04:31.000Z",          "type": "invoice",          "id": "string",          "number": "INV-0001",          "amount": 2878,          "balance": 2878        }      ],      "closing": 2878    }  ]}