Get eSIMs list

GET

/v2/sims

This endpoint allows you to retrieve a list of your eSIMs from the Airalo Partners API. You can customize the results using various filters and include related data in the response by specifying optional parameters.

The access token, obtained from the "Request Access Token" endpoint, should be included in the request.

direct_apple_installation_url:

Partner API now supports direct installation on iOS devices. With the introduction of Universal Links by Apple, users with iOS 17.4 or higher can directly install eSIMs using a special URL, which can be provided to your end clients if they are using iOS version 17.4 or above.

Request

Query Params

Header Params

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request GET '/v2/sims?include=order,order.status,order.user,share&filter[created_at]=Y-m-d - Y-m-d&filter[iccid]=8944465400000217735&limit=100&page=1' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {{token}}'

Responses

🟠422eSIMs List (422)

application/json

Body

Example

{
    "data": {
        "limit": "The limit must be an integer."
    },
    "meta": {
        "message": "the parameter is invalid"
    }
}

🟢200eSIMs List (200)

Modified at 2025-07-10 09:56:07

Get top-up package list

Get eSIM package history