Get usage (data, text & voice)

GET

/v2/sims/{sim_iccid}/usage

Endpoint do support new type of packages - "Voice and Text"
This endpoint comes with a Rate Limit: you can pull specific eSIM usage info once every 15 minutes.

If you send another request too soon, the server's going to respond with a 429 HTTP code. Please check the 'Retry-After' header, it'll tell you how many seconds to wait before the rate limit resets and you can fetch fresh info.

Please, use a caching mechanism on the client side to deal with frequent customer requests.

This endpoint enables you to retrieve the total data usage and usage details for a specific eSIM identified by its ICCID.

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

For more informations, best practices visit our FAQ page: https://airalopartners.zendesk.com/hc/en-us/sections/13207524820893-FAQ

Request

Path Params

sim_iccid

string

required

The ICCID of the eSIM for which you want to retrieve the data usage details.

Header Params

string

required

Example:

application/json

Authorization

string

required

Example:

Bearer {{token}}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET '/v2/sims//usage' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {{token}}'

Responses

🟢200Get Usage: 200

application/json

Body

object {0}

Example

{
    "data": {
        "remaining": 767,
        "total": 2048,
        "expired_at": "2022-01-01 00:00:00",
        "is_unlimited": true,
        "status": "ACTIVE", // All Cases: [ NOT_ACTIVE, ACTIVE, FINISHED, UNKNOWN, EXPIRED ]
        "remaining_voice": 0,
        "remaining_text": 0,
        "total_voice": 0,
        "total_text": 0
    },
    "meta": {
        "message": "api.succes"
    }
}

🟠404Get Usage: 404 (Invalid ICCID)

🟠429Get Usage: 429 (Rate Limit)

🟢200Get Usage (Recycled sim): 200

Submit order async

Submit top-up order