v1

latestOpenAPI 3.0.32026-07-264469137.7 KB

Refunds

List refunds

Retrieve a paginated list of refunds for your organization, ordered from most recent to oldest.

get/v1/refunds

Query parameters

limitinteger

Number of refunds to return. Min 1, max 100. Default 50.

offsetinteger

Number of refunds to skip before returning results. Default 0.

status'PROCESSING' | 'SUCCESS' | 'FAILED'

Filter by refund status. Accepted values: PROCESSING, SUCCESS, FAILED.

Response

Success - Refunds listed

totalinteger

Total number of refunds matching the query, across all pages.

Example response

{
  "total": 42,
  "items": [
    {
      "refund_id": "ref_1a2b3c4d5e",
      "charge_id": "chr_1a2b3c4d5e6f",
      "reference": "refund_9876",
      "status": "processing",
      "requested_amount": "29.00",
      "refund_fee_amount": "0.00",
      "fee_bearer": "merchant",
      "reason": "Customer requested cancellation",
      "created_at": "2026-04-27T12:00:00Z",
      "updated_at": "2026-04-27T12:00:00Z"
    }
  ]
}