v1

latestOpenAPI 3.0.22026-07-24184452.0 KB
Assets

Data Usage Details

List usage details for a specific SIM type attached to an asset.

<b>Super SIM (supersim):</b>

<ul> <li>Supports <code>hourly</code> (last 14 days) and <code>daily</code> (last 3 months).</li> <li>Returns usage split by <code>network</code>, showing <code>upload</code> and <code>download</code> bytes.</li> </ul>

<b>PRO SIM (prosim):</b>

<ul> <li>Supports <b>ONLY</b> <code>daily</code> (last 3 months). Hourly requests will return an error.</li> <li>Returns usage by <code>service_profile</code>, showing the <code>total</code> bytes used.</li> </ul> <div style="background-color: rgba(212, 31, 28, 0.1); border-left: 5px solid #d41f1c; padding: 10px; margin-top: 10px;"> <b>Reporting Recommendation:</b> If you are using this API endpoint to generate critical reports (e.g., consumption reports, balance analysis, etc.), please note the data finalization periods: <ul> <li><b>Super SIM:</b> Wait at least <b>24 hours</b> after the reported period ends.</li> <li><b>PRO SIM:</b> Due to delayed CDR reconciliations from global roaming partners, wait up to <b>10 days</b> for data to be completely finalized.</li> </ul> During these periods, you may notice discrepancies as late-arriving consumption events are processed. </div>
get/assets/{asset_id}/sims/{sim_type}/usages

Path parameters

sim_type'supersim' | 'prosim' required

Type of the SIM. Use 'supersim' for Super SIMs and 'prosim' for PRO SIMs.

Type of the SIM. Use 'supersim' for Super SIMs and 'prosim' for PRO SIMs.

asset_idstring required

Serial Number, UUID, SIM SID or SIM ICCID

Serial Number, UUID, SIM SID or SIM ICCID

Query parameters

granularity'hourly' | 'daily'

Response

Success

sim_type'supersim' | 'prosim' required

The type of SIM queried

granularity'hourly' | 'daily' required

Granularity of the records