Get Data Usage

GET

/v1/sims/{sim_iccid}/usage

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.

Request Example

Shell

JavaScript

Java

Swift

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

Response Example

200 - Get Usage: 200

{
    "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 ]
    },
    "meta": {
        "message": "api.succes"
    }
}

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}}

Responses

🟢200Get Usage: 200

application/json

Body

object {0}

🟠404Get Usage: 404 (Invalid ICCID)

🟠429Get Usage: 429 (Rate Limit)

🟢200Get Usage (Recycled sim)

Modified at 2025-05-12 15:00:30

Get Installation instructions

Get Top-up Package List