API v3
GET /number_orders/{id}
One number order: its status and the number delivered.
Another account's order is 404. Orders are kept for as long as the account exists.
Addresshttps://api.voicepro.plus/v3/number_orders/{id}
Key permissionnumbers:read
Fields
| Name | In | Type | |
|---|---|---|---|
| id * | path | string |
* required
Example
curl -X GET "https://api.voicepro.plus/v3/number_orders/nord_p6wz2kq7mx4rd3nh5cbtvfya" \ -H "Authorization: Bearer vpkey_YOUR_KEY"
Response
{
"object": "number_order",
"id": "nord_p6wz2kq7mx4rd3nh5cbtvfya",
"status": "completed",
"offer_id": "nof_m3xk7q2zrw4pdn6hc5tbvfya",
"phone_number": "+442079460188",
"number_id": "num_r5kx2wq7mz4pd3nh6cbtvfya",
"charged": {
"amount": 150,
"currency": "USD"
},
"created_at": "2026-10-28T09:30:00Z"
}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.