Request refund

POST

/v2/refund

💡

This endpoint comes with a Rate Limit: 5 requests per 1 minute 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

Responses

🟢202Accepted

application/json

Bodyapplication/json

🟠422Parameter Error

🟠429Too Many Attempts

Request Example

Shell

JavaScript

Java

Swift

curl --location '/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"'

Response Example

202 - Success

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

Modified at 2026-06-29 08:10:42

Request refund

Place order

Request refund

Overview#

⚠️ Important Disclaimer#

Request

Responses

Overview

⚠️ Important Disclaimer