API v3
GET /iot/sims
IoT SIMs. 404 service_not_enabled without IoT.
Addresshttps://api.voicepro.plus/v3/iot/sims
Key permissionread
Fields
| Name | In | Type | |
|---|---|---|---|
| limit | query | integer | |
| cursor | query | string | next_cursor from the previous page. |
* required
Example
curl -X GET "https://api.voicepro.plus/v3/iot/sims" \ -H "Authorization: Bearer vpkey_YOUR_KEY"
Response
{
"object": "list",
"data": [
{
"object": "iot_sim",
"id": "sim_7k2mqqxw4hd3nvbc5rtfz6ya",
"iccid": "8944501234567890123",
"label": "Trailer tracker 12",
"activated": true,
"online": true,
"network": {
"name": "Network GB",
"country": "GB",
"mcc": "234",
"mnc": "10"
},
"network_type": "4G",
"last_seen_at": "2026-10-28T08:52:11Z",
"imei_lock": null,
"data_limit": {
"total_bytes": 524288000,
"period": "monthly",
"alert_bytes": 419430400
},
"month_bytes": 73400320,
"data_as_of": "2026-10-28T08:55:00Z"
}
],
"has_more": false,
"next_cursor": null
}Errors
Every error has the same shape: { "error": { "type", "code", "message", "param", "request_id" } }.
missing_api_key401: No Authorization header, or not a Bearer key.
invalid_api_key401: The key is not recognised.
api_key_revoked401: The key was revoked in the portal.
api_key_expired401: The key passed the expiry date set on it.
missing_scope403: The key lacks the scope this endpoint needs; param names the scope.
ip_not_allowed403: The key has an IP allowlist and this request came from elsewhere.
account_not_active403: The workspace is suspended or closed.
route_not_found404: No such path in v3.
resource_not_found404: No object with that id on this account.
service_not_enabled404: The account does not have this service (voice trunk, IoT, numbers); param names it.
rate_limited429: Too many requests for this key or for the whole account (the message says which); wait Retry-After seconds.
internal_error500: Our fault. Quote the request_id to support.