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

Available to all partners, but approval is not automatic.

The refund endpoint is enabled by default for all API partners; no activation or request is required to start using it.
Submitting a request does not guarantee a refund. Every request is manually reviewed by Airalo's Customer Support team against Airalo's Refund Policy to confirm it meets all terms and conditions.
Approval and fulfilment remain subject to Airalo's internal policies and decisions. If your request meets the contract terms, the refund is credited to your account as Airalo credits for future transactions.

Request

Header Params

Body Params multipart/form-data

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' \
--form 'iccids="[\"894000000000001\",  \"894000000000002\"]"' \
--form 'reason="\"INSTALLATION_FAILURE\""' \
--form 'notes=""' \
--form 'email="email@example.com"'

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

Modified at 2026-06-15 15:44:20

Request refund

Install eSIM

Request refund

Overview#

⚠️ Important Disclaimer#

Request

Request Code Samples

Responses

Overview

⚠️ Important Disclaimer