List refund requests

GET/v1/refund-requestsesims:read

Returns the refund requests opened for your account, from the API or from the portal, newest first and cursor-paginated.

Query parameters

Name	Type	Default	Notes
status	string	—	PENDING, APPROVED, REJECTED or CANCELLED
limit	integer	50	Maximum 200
cursor	string	—	next_cursor from the previous page

curl 'https://partner-api.esimfo.com/v1/refund-requests?status=PENDING' \
  -H 'Authorization: Bearer esf_live_at_...'

Response 200

Field	Type	Notes
data[]	array	Requests — the same fields as Get a refund request
next_cursor	string | null	Pass as cursor for the next page
has_more	boolean	Whether another page exists

{
  "data": [
    {
      "id": "rfr_5e7a12c3",
      "esim_id": "esm_9a3f1c",
      "iccid": "89852350326100409575",
      "status": "APPROVED",
      "reason": "WRONG_PURCHASE",
      "notes": "Customer bought a Turkey package but is travelling to Greece",
      "review_note": null,
      "refunded_amount": "2.80",
      "currency": "EUR",
      "created_at": "2026-08-22T10:12:44.000Z",
      "reviewed_at": "2026-08-22T13:40:02.000Z"
    },
    {
      "id": "rfr_2c91e0a4",
      "esim_id": "esm_9a3f0b",
      "iccid": "89852350326100409412",
      "status": "REJECTED",
      "reason": "CHANGE_OF_PLAN",
      "notes": null,
      "review_note": "The line was installed and used 1.2 GB; the network does not refund used lines.",
      "refunded_amount": null,
      "currency": "EUR",
      "created_at": "2026-08-20T14:02:51.000Z",
      "reviewed_at": "2026-08-21T08:17:09.000Z"
    }
  ],
  "next_cursor": null,
  "has_more": false
}

Errors

Status	Code	Cause
403	insufficient_scope	Key lacks esims:read