Get usage (data, text & voice)
GET
/v2/sims/{sim_iccid}/usage
remaining, total and amount fields will default to 0 should be ignored, and not displayed to the end users.is_unlimited field can be false for an unlimited package ordered, due to not having real eSIMs available, thus don't reflect real usage.total : Response value is total megabytes on packageremaining : Response value is in total megabytes remainingtotal_text : Response value is the initial total text messages on packageremaining_text : Response value is in total number of text messages remainingtotal_voice : Response value is the initial total voice minutes on packageremaining_voice : Response value is in total minutes remainingRequest
Path Params
Header Params
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/v2/sims//usage' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {{token}}' \
--header 'url: https://partners-api.airalo.com'Response 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 ]
"remaining_voice": 0,
"remaining_text": 0,
"total_voice": 0,
"total_text": 0
},
"meta": {
"message": "api.succes"
}
}Modified at 2026-06-05 12:16:11