Airalo Developer Platform
  1. Place order
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
          POST
        • Submit order async
          POST
        • Future orders
          POST
        • eSIM voucher
          POST
      • 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
        • Cancel future orders
        • Get order
        • Update eSIM brand
      • 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. Place order

Future orders

POST
/v2/future-orders
This endpoint allows you to submit an order to the Airalo Partner API, which will be created on the specified due date.
To proceed, provide the required information:
Due date
Quantity
Package ID
Description (optional)
Please note:
On success, the endpoint response will include a unique 25-character request_id.
You must store this value in your system to cancel the order later if needed and to know for which order you got a response on your webhook URL.
An access token from the "Request Access Token" endpoint is required in the request.
Delivery modes
What is a webhook URL?
Webhook URL is a URL that is configured on your domain and your won webserver.
That URL should be able to receive HTTP POST requests with your order data that will be sent from our servers .
NOTE: We check the liveness of your webhook URL with an HTTP HEAD request to which we expect 200 OK response.
What happens when the due date arrives?
When the due date arrives your order is processed and the order details are sent as a POST HTTP request to
either your opted in "async_orders" notification type url (more info here )
or on the "webhhok_url" optional parameter of this endpoint which overrides the above opted in URL.
NOTE that you must have one of the above (either opted in URL or webhhok_url) provided in order to make a future order.
if you provide the optional parameter "sharing_option", which goes together with the "to_email" parameter
then an email with the eSim details will also be sent to the email provided in the "to_email" parameter as well.
Depending from the selected sharing option which can be one of link or pdf or both you will get the eSim data
either in a PDF format attached to the email or as a link.
What is the format of the message that is sent to the webhook URL?
The format of the message that is sent to the webhook URL is the same as the response of the regular order.
It only has one additional parameter named "request_id" which is the same request_id that you got in the response
when you made the future order at the time of making the order,
so that you know for which future order you got details on your webhook URL.
For more details and best practices, visit our FAQ page.

Request

Header Params

Body Params application/json

Examples
Request with "webhook_url"
With this request a future order will be created that will be processed on date 2025-04-09 10:00 and when the ordfer is complete the order details will be delivered to the URL provided in the "webhook_url" parameter.
NOTE that this URL is a URL that is hosted by your webserver.
{
    "quantity": 1,
    "package_id": "change-7days-1gb",
    "due_date": "2025-04-09 10:00",
    "description": "Just a future order ..",
    "webhook_url": "http://somePartnerDomain.com/webhook-url-path-to-wait-for-the order-details"
}

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
curl --location --request POST '/v2/future-orders' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {ACCESS_TOKEN}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "quantity": 1,
    "package_id": "change-7days-1gb",
    "due_date": "2025-04-09 10:00",
    "description": "Just a future order ..",
    "webhook_url": "http://somePartnerDomain.com/webhook-url-path-to-wait-for-the order-details"
}'

Responses

🟢200Submit Future Order
application/json
Body

Example
{
    "data": {
        "request_id": "9HrK4-KGgz8n71eGgdNS5cV7Y",
        "due_date": "2025-03-28 10:00",
        "latest_cancellation_date": "2025-03-27 10:00"
    },
    "meta": {
        "message": "success"
    }
}
🟠422Quantity validation error
🟠422Invalid package validation error
🟠422Invalid due date validation error
🟠422Invalid sharing option
Modified at 2025-07-14 12:07:22
Previous
Submit order async
Next
eSIM voucher
Built with