List Refunds
GET/api/v1/refunds
- operationId
- payments.ListRefunds
- Permission
- refund.list
Parameters
| Field | in | Type | Required | Description |
|---|---|---|---|---|
| cursor | query | string | ||
| limit | query | integer | ||
| payment_id | query | string | ||
| requested_by | query | string | ||
| status | query | string | ||
| PG-Version | header | string |
Responses
200 OK
Response headers: `X-Request-Id`
| Field | Type | Required | Description |
|---|---|---|---|
| data | Refund[] | ||
| has_more | boolean | ||
| next_cursor | string | null |
{
"data": [
{
"amount": {
"currency": "string",
"minor": 0
},
"created_at": "2026-10-01T09:00:00Z",
"id": "string",
"number": "string",
"payment_id": "string",
"reason": "string",
"reason_code": 0,
"status": "requested",
"succeeded_at": "2026-10-01T09:00:00Z"
}
],
"has_more": false,
"next_cursor": "string"
}default Error
| Field | Type | Required | Description |
|---|---|---|---|
| code | string | Yes | |
| detail | string | ||
| details | object | ||
| errors | object[] | ||
| errors.code | string | ||
| errors.field | string | ||
| errors.message | string | ||
| instance | string | ||
| status | integer | Yes | |
| title | string | Yes | |
| type | string |
{
"code": "string",
"detail": "string",
"details": {},
"errors": [
{
"code": "string",
"field": "string",
"message": "string"
}
],
"instance": "string",
"status": 0,
"title": "string",
"type": "string"
}Errors
Derived from the modules this operation touches, because the snapshot carries no x-errors list yet — it may list codes this operation cannot return.
Try it
GET/refundsMakes a real call in test mode with your own key. The key stays in this tab and is never sent anywhere but the API.
No API base URL is configured for this environment, so try-it is unavailable.
Starts with pg_test_. A live key is refused before any request is made.
curl -X GET '<API_BASE_URL>/api/v1/refunds' \
-H 'Authorization: Bearer pg_test_…' \
-H 'PG-Version: 2026-09-01'