Get a refund request

GET/v1/refund-requests/{id}esims:read

Returns one refund request. Poll this if you do not use webhooks: status moves from PENDING to APPROVED or REJECTED once eSIMfo has reviewed it.

Path parameters

Name	Notes
id	The request id returned by Request a refund

curl https://partner-api.esimfo.com/v1/refund-requests/rfr_5e7a12c3 \
  -H 'Authorization: Bearer esf_live_at_...'

Response 200

{
  "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"
}

Field	Notes
status	PENDING, APPROVED, REJECTED or CANCELLED
review_note	The rejection reason, or a note on approval
refunded_amount	The amount credited to your balance; null unless approved
reviewed_at	When eSIMfo decided; null while pending

Errors

Status	Code	Cause
404	not_found	No such request, or it belongs to another account
403	insufficient_scope	Key lacks esims:read