Store APIsRefunds
List refunds
Returns a list of refunds issued on the store, most recent first. Requires the REFUNDS_READ scope.
AuthorizationBearer <token>
Bearer token authentication. Pass the secret directly in the Authorization header. Token secrets start with sk_.
In: header
Path Parameters
storeId*string
Length
12 <= length <= 48Query Parameters
page?integer
Range
1 <= valueDefault
1limit?integer
Range
1 <= value <= 100Default
25status?||
sort?|
Header Parameters
idempotency-key?string
Length
8 <= length <= 32Response Body
application/json
application/json
curl -X GET "https://example.com/stores/stringstring/refunds/"{ "ok": true, "data": { "items": [ { "id": "rfd_3kx9p2vqwm5j8h0r1n4tzcbf", "amount": 2900, "status": "COMPLETED", "reason": "REQUESTED_BY_CUSTOMER", "createdAt": "2026-05-14T12:34:56.000Z", "order": { "id": "ord_p2v8q1mzj0kxw5h7n4tr3bcf", "orderNumber": "cs_abcdef0123456789", "customer": { "id": "cus_j8h0r1n4tzcbfp2v8q1mzwx5", "email": "buyer@example.com" } } } ], "pagination": { "page": 1, "limit": 25, "total": 1, "totalPages": 1 } }}