SettleFlow API
API ReferenceRefunds

List refunds

GET
/refunds

Returns a paginated list of refunds matching the given filters.

X-Api-Key<token>

Merchant API key for authentication

In: header

Query Parameters

page?integer
Range1 <= value
Default1
limit?integer
Range1 <= value <= 300
Default20
sortBy?string
order?string
Default"desc"

Value in

  • "asc"
  • "desc"
status?string

Filter by refund status.

Value in

  • "pending"
  • "processing"
  • "succeeded"
  • "failed"
  • "cancelled"
from?string

Only refunds requested at/after this ISO 8601 time.

Formatdate-time
to?string

Only refunds requested at/before this ISO 8601 time.

Formatdate-time

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/refunds"
{  "data": [    {      "id": "string",      "payment_id": "string",      "amount": 0,      "currency": "string",      "status": "string",      "reason": "string",      "requested_at": "2019-08-24T14:15:22Z",      "succeeded_at": "2019-08-24T14:15:22Z"    }  ],  "meta": {    "page": 0,    "limit": 0,    "total": 0,    "totalPages": 0  }}