VoicePro Plus API v3

{
  "error": {
    "type": "authentication",
    "code": "invalid_api_key",
    "message": "This API key is not recognised.",
    "request_id": "req_..."
  }
}

Account

SIMs

IoT SIMs

IoT connectors

Numbers

Voice trunk

Activity

Billing

Dips

Webhooks

Add webhooks by API (POST /webhooks, with a key that has the webhooks:write scope) or in the portal, under Account, then API and webhooks (owners and admins). A webhook has an HTTPS address and one or more event types (events, up to 20), and gets a signing secret shown once.

We POST JSON with X-VoicePro-Event and two signatures made with your secret. VoicePro-Signature is t=<unix seconds>,v1=<hex>, the HMAC-SHA256 of the time, a dot and the raw body: check it, and refuse a time more than 5 minutes old so an old message cannot be replayed. X-VoicePro-Signature is the HMAC-SHA256 of the raw body alone, as before.

Each delivery has a 10-second timeout. One that does not answer 2xx is tried again, after 15 minutes, 1, 3, 6, 12 and 24 hours, for up to 3 days; X-VoicePro-Delivery-Attempt says which try it is. Every event carries an id, so a receiver can ignore one it has already handled. The last 50 deliveries for each webhook are in GET /webhooks/{id}/deliveries and the portal, and 30 days of events in GET /events; POST /events/{id}/resend sends one again. POST /webhooks/{id}/test (or the portal's Test button) sends a signed test delivery to your address. A SIM suspended or reactivated, a number transfer update and events from the IoT network are sent straight away; spending, data cap, roaming, answer rate, invoice, incident and alert rule events are checked every 15 minutes.

# Claude Code
claude mcp add --transport http voicepro https://api.voicepro.plus/mcp \
  --header "Authorization: Bearer vpkey_test_YOUR_KEY"

# Cursor (.cursor/mcp.json)
{ "mcpServers": { "voicepro": { "url": "https://api.voicepro.plus/mcp",
  "headers": { "Authorization": "Bearer vpkey_test_YOUR_KEY" } } } }

The version is in the address: https://api.voicepro.plus/v3. Within v3 we only add: new calls, new optional fields and new values. Your code should ignore fields and values it does not know.

A breaking change only ever ships as a new major version, and the previous version keeps working for at least 12 months after we announce it, with a Sunset header on its responses.

Our uptime target is 99.9% each calendar month, reported on the status page.

Cancel a number, and number watches

• POST /numbers/{id}/cancel: no further charges; the number keeps working to the end of the month already paid, then is released.
• Number watches: POST /number_watches re-checks a number daily and records every change (porting, network, line status, risk); GET /number_watches/{id}/events lists them.
• New webhook event number.watch_changed, sent when a watched number changes.
• The number check product is now named as it is everywhere else: code nrv (VPX-NRV, Number Range Verify).
• POST /dip_batches: check a file of up to 20,000 numbers, paid from your balance before it starts; anything not run is refunded.
• SIMs: POST /sims/{id}/suspend and /reactivate; IoT: POST /iot/sims/{id}/sms sends a text to the device.
• POST /port_requests: ask to transfer numbers in. POST /invoices/{id}/payment_link: a secure payment link for an open invoice. GET /invoices/{id}/pdf: the VAT invoice.
• Webhooks v2: several event types per webhook, a timestamped signature (VoicePro-Signature), retries for up to 3 days, and 30 days of events in GET /events with POST /events/{id}/resend.
• New key scopes: sms:send, porting:write and billing:write.

API v3

• The API moves to api.voicepro.plus/v3, with a new home at voicepro.plus/developers: get started, recipes, guides and a searchable reference with cURL, JavaScript and Python for every call.
• Test keys (vpkey_test_...): every call answers with example data, and number checks answer from fixed test numbers. Never charged.
• MCP server at api.voicepro.plus/mcp: AI assistants get one tool for every call, using your key.
• Downloads: OpenAPI 3.1 spec, Postman collection, TypeScript and Python clients, and the whole reference as plain text for AI tools.
• Portal: API and webhooks now lists every request each key made in the last 30 days.
• DELETE /iot/connectors/{name} is now listed in the reference (it was live but not shown).
• New calls: GET /trunks/channels (channels in use per trunk, now and at peak), GET /fraud/incidents (your fraud incidents and losses, with the previous period) and GET /risk_ranges (search the high-risk and premium-rate ranges our network screens against).
• New call: GET /number_requirements (what you must supply, per country and number type, before a number goes live).
• Webhooks by API: list the events, create, change, pause, delete and test webhooks, and read each one's deliveries (GET/POST /webhooks and /webhooks/{id}).
• IoT SIMs: change one SIM (PATCH /iot/sims/{id}: name, on or off, IMEI lock, data limit, technologies), its eSIM state and SMS history, and your network lists with a SIM put on one.