Skip to main content
GET
List refunds
Authenticate with an API key that belongs to the target organization. Each refund has the same fields as the refund.succeeded and refund.failed webhooks, so you can reconcile events and API reads with the same code. status is succeeded, failed, or pending (still awaiting review or processing). No webhook is sent for pending; the refund sends refund.succeeded or refund.failed when it ends. To reconcile a period, filter by date_from and date_to and page through the results. To see every refund on one order, filter by order_id. totalRefundedCents and fullyRefunded describe the order at the time of the request. A webhook carries them as of its event, so once a later refund on the same order succeeds, the API shows a higher total than that earlier webhook did.

Authorizations

X-API-Key
string
header
required

Merchant API key (format: ak_BASE64)

Query Parameters

page
integer
default:1

Page number

size
integer
default:20

Page size (max 100)

order_id
string

Filter by order ID (ORD_...)

status
string

succeeded, failed or pending

date_from
integer

Refunds requested at or after this unix timestamp

date_to
integer

Refunds requested at or before this unix timestamp

Response

OK

data
object
error
object
message
string
success
boolean