Airalo Developer Platform
  1. Manage orders & eSIMs
Airalo Developer Platform
  • OVERVIEW
    • Introduction
    • Attribute descriptions
    • FAQ
    • Quick start
      • Step 1: Request access token
      • Step 2: Get packages
      • Step 3: Submit order
      • Step 4: Get installation instructions
    • User journeys
      • Purchase journey
      • Top-up journey
    • Guides
      • How to set up a brand for eSIMs Cloud link sharing
      • How to get the eSIMs Cloud sharing link through API
      • How to generate the QR code for an eSIM
      • eSIM installation methods for API Partners
  • REST API
    • Introduction
    • Rate limits
    • Error handling
    • Endpoints
      • Authenticate
        • Request access token
      • Browse packages
        • Get packages
        • Get compatible device list
      • Place order
        • Submit order
        • Submit order async
        • Future orders
        • eSIM voucher
      • Install eSIM
        • Get eSIM
        • Get installation instructions
      • Monitor usage
        • Get usage (data, text & voice)
      • Place top up order
        • Submit top-up order
        • Get top-up package list
        • Get eSIMs list
        • Get eSIM package history
      • Manage orders & eSIMs
        • Get order list
          GET
        • Cancel future orders
          POST
        • Get order
          GET
        • Update eSIM brand
          PUT
      • Notifications
        • Airalo webhooks optin and flow
        • Understanding webhooks: Asynchronous communication for modern applications
        • Async orders
        • Low data notification - opt In
        • Low data notification - opt out
        • Get low data notification
        • Credit limit notification
        • Webhook definition
        • Webhook simulator
      • Check balance
        • Get balance
      • Refunds
        • Refund request
    • Guides
      • Step #1 - Authentication
  • SDKs
    • Introduction
    • SDK vs. REST API
    • Technical notes
  • WOOCOMMERCE PLUGIN
    • Introduction
    • Guides
      • How to install the plugin
      • How to setup the Shop price?
      • Customizing "My eSIM" page colors in WooCommerce
      • How to convert prices into local currency
      • How to finalize the shop setup
      • How to test in sandbox
      • How to go live
      • Customizing WooCommerce email templates for eSIM sales
  1. Manage orders & eSIMs

Cancel future orders

POST
/v2/cancel-future-orders
This endpoint allows you to submit future order cancellation requests via the Airalo Partner API.
To proceed, provide an array of request_id strings from the "Create Future Order" endpoint response.
Please note:
Future orders can be canceled up to 24 hours before the due date.
You can include up to 10 future orders in a single request.
An access token from the "Request Access Token" endpoint is required.
For more details and best practices, visit our FAQ page.

Request

Header Params

Body Params application/json

Example
{
    "request_ids": [
        "wPnaOiEcdyP11pEPeJ-jLhT_I",
        "Q2FMVdpbIAFh0RVvtjKkya8a1",
        "OKjfHGS5qzRWzt74iKfm9YeVe"
    ]
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/v2/cancel-future-orders' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {ACCESS_TOKEN}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "request_ids": [
        "wPnaOiEcdyP11pEPeJ-jLhT_I",
        "Q2FMVdpbIAFh0RVvtjKkya8a1",
        "OKjfHGS5qzRWzt74iKfm9YeVe"
    ]
}'

Responses

🟢200Success
application/json
Body

Example
{
    "data": [],
    "meta": {
        "message": "Future orders cancelled successfully"
    }
}
🟠422Not valid request ID
🟠422Already processed request ID
🟠422Request Id does not exist
Modified at 2025-07-10 09:52:25
Previous
Get order list
Next
Get order
Built with