API v3

GET /iot/bulk_jobs/{id}

One bulk job with its progress.

Addresshttps://api.voicepro.plus/v3/iot/bulk_jobs/{id}

Key permissionread

Fields

Name	In	Type
id *	path	string

* required

Example

curl -X GET "https://api.voicepro.plus/v3/iot/bulk_jobs/bulk_3f9a1c7e5b2d4a6c8e0f1a2b" \
  -H "Authorization: Bearer vpkey_YOUR_KEY"

Response

{
  "object": "iot_bulk_job",
  "id": "bulk_3f9a1c7e5b2d4a6c8e0f1a2b",
  "status": "done",
  "change": {
    "data_limit": {
      "total_bytes": 1073741824,
      "period": "monthly",
      "alert_bytes": 858993459
    }
  },
  "total": 2,
  "processed": 2,
  "succeeded": 2,
  "failed": 0,
  "created_at": "2026-10-28T09:10:00Z",
  "finished_at": "2026-10-28T09:10:04Z"
}

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.

GET /iot/bulk_jobs/{id}

Fields

Example

Errors

More in IoT SIMs