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
    • Go live checklist
    • Endpoints
      • Authenticate
        • Request access token
      • Browse packages
        • Get packages
      • 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
        • Future Orders
          GET
      • Compatible devices
        • [Deprecated] Get compatible device list
        • Get compatible device lite list
      • Notifications
        • Airalo webhooks opt-in and flow
        • Webhooks guide
        • Webhook definition
        • Notification: Low data
          • Opt in
          • Get notification details
          • Opt out
        • Notification: Credit limit
          • Opt in
          • Get notification details
          • Opt out
        • Notification: Async orders
          • Opt in
          • Get notification details
          • Opt out
        • Webhook simulator
      • Check balance
        • Get balance
      • Request refund
        • Request refund
  • SDKs
    • Introduction
    • SDK vs. REST API
    • Technical notes
  • WOOCOMMERCE PLUGIN
    • Introduction
    • Guides
      • How to install the Airalo Plugin for WooCommerce
      • How to customize the "My eSIMs" page colors in WooCommerce
      • How to convert prices into your local currency
  • SHOPIFY APP
    • Introduction
    • Guides
      • How to install the Airalo Shopify App
      • How to set up prices in Shopify
  1. Manage orders & eSIMs

Future Orders

Developing
GET
/v2/future-orders
This endpoint allows you to get all your submitted future orders that are in pending, failed or retry status
The following filter parameters are available:
status (optional) - Defaults to pending. Other possible statuses are: failed and retry
limit (optional) - Defaults to 25. Limit the returned results
from_due_date - Datetime field in the format: Y-m-d H:i. Filters data starting from this date forward. Example: 2025-02-27 10:00
to_due_date - Datetime field in the format: Y-m-d H:i. Filters data starting from this date backward. Example: 2025-02-27 10:00
NOTE: that processed orders will not be displayed here.

Request

Query Params

Request Code 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 GET '/v2/future-orders?status&limit&from_due_date&to_due_date'

Responses

🟢200Success
application/json
Body

Example
{
    "data": [
        {
            "request_id": "ehFeHAa_R1GyIgHxNrP6Iz0Hy",
            "quantity": 1,
            "description": "",
            "status": "pending",
            "package_id": "change-7days-1gb",
            "due_date": "2025-03-24 10:00",
            "latest_cancellation_date": "2025-03-23 10:00"
        },
        {
            "request_id": "UPMpgaC9rWr799augw9KbI_ia",
            "quantity": 1,
            "description": "",
            "status": "pending",
            "package_id": "change-7days-1gb",
            "due_date": "2025-02-27 10:00",
            "latest_cancellation_date": "2025-02-26 10:00"
        },
        {
            "request_id": "-s5Cx8jTjvx2UH_euzhaHbwiu",
            "quantity": 1,
            "description": "",
            "status": "pending",
            "package_id": "change-7days-1gb",
            "due_date": "2025-02-27 10:00",
            "latest_cancellation_date": "2025-02-26 10:00"
        }
    ],
    "links": {
        "first": "https://partners-api.airalo.com/v2/future-orders?filter%5B%27status%27%5D=%27failed%27&status=pending&page=1",
        "last": "https://partners-api.airalo.com/v2/future-orders?filter%5B%27status%27%5D=%27failed%27&status=pending&page=3",
        "prev": null,
        "next": "https://partners-api.airalo.com/v2/future-orders?filter%5B%27status%27%5D=%27failed%27&status=pending&page=2"
    },
    "meta": {
        "message": "success",
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "path": "https://partners-api.airalo.com/v2/future-orders",
        "per_page": "25",
        "to": 3,
        "total": 3
    }
}
🟠422Invalid from due date
Modified at 2025-09-09 12:34:55
Previous
Update eSIM brand
Next
[Deprecated] Get compatible device list
Built with