1. REST API
Airalo Developer Platform
  • OVERVIEW
    • Introduction
    • Attribute descriptions
    • FAQ
    • Developer feedback
    • Quick start
      • Step 1: Request access token
      • Step 2: Get packages
      • Step 3: Submit order
      • Step 4: Get installation instructions
    • 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
    • Sandbox mode
    • Endpoints
      • Authenticate
        • Request access token
      • Browse packages
        • Get packages
      • Place order
        • Future orders
        • Submit order
        • Submit order async
        • eSIM voucher
      • Request refund
        • Request refund
      • Install eSIM
        • Get eSIM
        • Get installation instructions
      • Monitor usage
        • Get usage (data, text & voice)
      • Top up eSIM
        • Get top-up package list
        • Submit top-up order
      • Manage orders
        • Get order list
        • Get order
        • Cancel future orders
        • Future Orders
      • Manage eSIMs
        • Update eSIM brand
        • Get eSIMs list
        • Get eSIM package history
      • 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
  • 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
  1. REST API

Rate limits

API rate limits#

To ensure fair usage and maintain performance for all users, certain API endpoints are subject to rate limits. These limits restrict the number of requests that can be made to specific endpoints within a defined time period. Exceeding the rate limit will result in a 429 Too Many Attempts error response.

Understanding rate limits#

Each rate-limited endpoint has a defined threshold, typically measured in requests per minute or requests per hour. If your application exceeds this threshold, further requests will be temporarily blocked until the limit resets.

To avoid exceeding rate limits:#

Implement retry logic with exponential backoff.
Monitor your usage patterns and adjust your requests accordingly.

Sandbox mode specific rate limits#

All incoming requests per client_id are rate limited to 50 requests per 1 minute. Once the company is switched to Production mode, this rate limitation is lifted automatically.

Endpoint specific rate limits#

Below is a table of API endpoints with their respective rate limits:
EndpointLimitTime Window
/token3 requestsPer minute
/packages80 requestsPer minute per unique auth token
/sims/:iccid/usage10 requestsPer 1 minute for the same iccid
/sims/:iccid/usage5 requestsPer 1 second for the same client_id
/sims/:iccid/packages10 requestsPer 1 minute for the same iccid
/simulator/webhook1 requestPer 15 minutes per unique IP
/refund1 requestPer 5 minutes per unique IP
Modified at 2026-05-07 13:09:04
Previous
Introduction
Next
Error handling
Built with