InvoicesPayments and statements

List a customer's refunds

GET
/v1/customers/{id}/refunds

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/refunds"
{  "data": [    {      "id": "rfd_01K6XJ4Q8ZT3M9R5V2B7WDHNCA",      "number": "RFD-0001",      "customerId": "cus_01K6XJ4Q8ZT3M9R5V2B7WDHNCA",      "amount": 2878,      "currency": "USD",      "method": "bank_transfer",      "reference": null,      "createdAt": "2026-10-07T11:04:31.000Z"    }  ],  "nextCursor": null,  "total": 1}