API reference

DIDHub exposes a REST API for everything you can do in the dashboard — provisioning numbers, configuring SIP trunks, sending SMS, receiving webhooks, querying usage.

Base URL

https://api.didhub.io/v1

Authentication

All API requests authenticate with an API key passed in the Authorization header:

curl https://api.didhub.io/v1/numbers \
  -H "Authorization: Bearer $DIDHUB_API_KEY"

Generate keys in the dashboard at Settings → API & Webhooks → API keys. See Authentication for scopes, OAuth, and rotation guidance.

Content type

All POST / PATCH requests use application/json:

curl -X POST https://api.didhub.io/v1/numbers \
  -H "Authorization: Bearer $DIDHUB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country":"GB","area":"20","type":"geographic"}'

Interactive explorer

The full API surface is browsable with auth-aware "Try it" buttons:

Open the API explorer →

Resources

• Numbers — search inventory, buy, configure routing, port, release
• SIP trunks — provision, configure auth (IP ACL / digest), set capacity
• Calls — place outbound, query status, fetch recordings
• SMS — send, receive (webhook), DLR callbacks
• Billing — query usage, fetch invoices

Cross-cutting

• Authentication
• Errors & rate limits
• Webhooks