Get a refund request

GET

api_partner

esims

{topup_id}

refund

GET /v1/api_partner/esims/20250129123456123456789012/refund

{
  "topup_id": "20250129123456123456789012",
  "external_order_id": "ORDER-123456",
  "status": "rejected",
  "reason": "activation_failed",
  "note": "iPhone 13, installed before departure. No service in Tokyo with roaming on; restarted twice.",
  "rejection_reason": "esim_activated",
  "requested_at": "2026-10-28T03:12:45Z",
  "decided_at": "2026-10-29T01:20:00Z"
}

Returns the refund request for one eSIM, in the same shape as Request a refund. Use it if you have no webhook, or to check a decision you think you missed. The refund webhook is still the way to hear about a decision as it happens — do not poll this in a loop.

Path parameter

string

required

The unit’s topup_id.

Signing a GET

The body hash is taken over the empty string. See Authentication.

GET /v1/api_partner/esims/20250129123456123456789012/refund

{
  "topup_id": "20250129123456123456789012",
  "external_order_id": "ORDER-123456",
  "status": "rejected",
  "reason": "activation_failed",
  "note": "iPhone 13, installed before departure. No service in Tokyo with roaming on; restarted twice.",
  "rejection_reason": "esim_activated",
  "requested_at": "2026-10-28T03:12:45Z",
  "decided_at": "2026-10-29T01:20:00Z"
}

Status

`status`	Meaning	Final
`pending`	Received and waiting for review. `decided_at` is `null`	No
`approved`	Refunded. Settled as a credit on your next invoice	Yes
`rejected`	Not refunded. `rejection_reason` says why	Yes

A decided request does not change again. Every field is described under Request a refund.

Errors

Status	`code`	Cause
`401`	`unauthorized`	Signature headers missing, expired or wrong
`404`	`not_found`	No eSIM with that `topup_id` on your account, or no refund request for it. `message` says which
`429`	—	Shares the 30-a-minute limit with Request a refund

Last modified on November 2, 2026

GET /v1/api_partner/esims/20250129123456123456789012/refund

{
  "topup_id": "20250129123456123456789012",
  "external_order_id": "ORDER-123456",
  "status": "rejected",
  "reason": "activation_failed",
  "note": "iPhone 13, installed before departure. No service in Tokyo with roaming on; restarted twice.",
  "rejection_reason": "esim_activated",
  "requested_at": "2026-10-28T03:12:45Z",
  "decided_at": "2026-10-29T01:20:00Z"
}

Get Started

Products

Orders

Refunds

Webhooks

Path parameter

Signing a GET

Status

Errors

​Path parameter

​Signing a GET

​Status

​Errors

Path parameter

Signing a GET

Status

Errors