# Introduction

## REST API overview
The Airalo Partner API provides seamless access to Airalo’s eSIMs, allowing you to integrate core connectivity features directly into your application or system. Whether you’re managing eSIM orders, sharing eSIMs with users, or receiving real-time notifications when data is running low, this REST API gives you the tools to deliver a reliable and scalable connectivity solution tailored for travelers.

Use this API to enhance your product offering by enabling your users to discover, purchase, and manage travel eSIMs effortlessly.


## Future versions
Airalo reserves the right to extend the Partner API responses and requests with new attributes. Partners must ensure their integration can handle these changes, as they are considered backward-compatible.



:::highlight orange ❗
**Version 1 of the Partner API is being retired in 2027.**
- **1st January 2027:** Migration support begins. Your account manager can help you plan and test the move.
- **1st March 2027:** v1 requests are still accepted, but they are processed by v2 and return v2 responses. If your integration has not been updated by then, it starts receiving the v2 response format from this date.
- **1st May 2027:** v1 is switched off, and requests to v1 endpoints are rejected.

Follow the [Upgrade from V1 to V2 guide](/upgrade-from-v1-to-v2-2483650m0) to prepare your integration. 

*For many integrations the move is as simple as a URL change.* 
::: 
 

## API modes
To simplify integration and streamline workflows, the Airalo Partner API now operates in a single environment where you can switch between Sandbox and Production modes using a configuration setting. This unified approach eliminates the need for separate base URLs or different API credentials, and ensures a smoother transition from testing to live using the same production eSIM packages across both modes.


| Mode | Description                                                                                                                         |
|-------------|-------------------------------------------------------------------------------------------------------------------------------------|
| Sandbox     | A simulation mode used for development and testing. API requests in this mode do not affect live data or trigger real provisioning, while still using the production eSIM packages. Ideal for validating your integration before going live. |
| Production  | A Production mode used for real transactions and provisioning. Switch to this mode once your application is fully tested and ready for deployment. |