Refund request

POST

/v2/refund

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.
Please note that access to this API requires a contract amendment. Make sure you have the right agreement in place before intergrating the service into you workflow.

Request Example

Shell

JavaScript

Java

Swift

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

Response Example

202 - Success

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

Request

Header Params

Body Params text/plain

Examples

Responses

🟢202Accepted

application/json

Body

🟠422Parameter Error

Modified at 2025-07-14 12:08:40

Get balance

Step #1 - Authentication

Refund request

Overview#

⚠️ Important Disclaimer#

Request

Responses

Overview

⚠️ Important Disclaimer