Request refund

POST

/v2/refund

💡

This endpoint comes with a Rate Limit: 1 request per 5 minutes per unique IP address.

Overview

The Airalo Refund API makes it simple to request refunds for eSIMs. This guide walks you through everything you need to know, including the API endpoint, request and response formats, error handling, and sample requests.

⚠️ Important Disclaimer

The Refund API helps streamline the refund request process by reducing manual effort. However, submitting a request through this API does not guarantee approval.
Each refund request is individually reviewed based on Airalo's Refund Policy to ensure it meets all terms and conditions. Refund approvals remain subject to Airalo’s internal policies and decisions.
If your request meets the contract terms, the refund will be credited to your account as Airalo credits, ready to use for future transactions.

Request

Header Params

Body Params text/plain

Example

Required Fields

`iccids`

Type: array

Description: An array of ICCIDs (max 5). Each ICCID must be a string of digits.

`reason`

Type: string

Description: The reason for the refund. Accepted values listed below.

Accepted Reason Values:

INSTALLATION_FAILURE

NO_COVERAGE

APN_FAILURE

TRIP_CANCELLATION

INTERMITTENT_CONNECTION

BLOCKED_NETWORK

CHANGE_OF_PLAN

DELETED_ESIM

EARLY_EXPIRY

HOTSPOT_NOT_WORKING

IMSI_CHANGE

INCOMPATIBLE_DEVICE

LOCKED_DEVICE

NO_VOICE_TEXT_SERVICES

OVERCHARGED

SLOW_SPEED

TOP_UP_PACKAGE_FAILURE

UNKNOWN_CHARGES

WRONG_PURCHASE

UNABLE_TO_ACCESS_APPS

SERVICE_DEGRADATION

QR_ISSUE_PARTNERS

OTHERS

Optional Fields

`notes`

Type: string

Description: Additional notes (max 255 characters). Required if reason is "OTHERS".

`email`

Type: string

Description: Optional email address for follow-up (must be a valid email).

Example: { "iccids": [ "894000000000001", "894000000000002" ], "reason": "SERVICE_ISSUES", "notes": "Connection issues in the region." }

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://partners-api.airalo.com/v2/refund' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {{token}}' \
--header 'url: https://partners-api.airalo.com' \
--header 'Content-Type: text/plain' \
--data '{
  "iccids": [
    "894000000000001",
    "894000000000002"
  ],
  "reason": "SERVICE_ISSUES",
  "notes": "Connection issues in the region."
}'

Responses

🟢202Accepted

application/json

Bodyapplication/json

Examples

SuccessInvalid ICCIDsMissing Required FieldsInvalid Reason

{
    "data": {
        "refund_id": "12345",
        "created_at": "2024-10-12 09:30"
    },
    "meta": {
        "message": "success"
    }
}

🟠422Parameter Error

🟠429Too Many Attempts

🟠403403 Forbiden

Modified at 2026-05-07 13:09:04

Request refund

Install eSIM

Request refund

Overview#

⚠️ Important Disclaimer#

Request

Required Fields

iccids

reason

Accepted Reason Values:

Optional Fields

notes

email

Request Code Samples

Responses

Overview

⚠️ Important Disclaimer

`iccids`

`reason`

`notes`

`email`