Subscriptions
Bandwidth uses HTTP Callbacks (also known as webhooks) to send number ordering & porting events to any publicly addressable url.
In order to successfully use the Number Ordering & Porting APIs you need to configure an subscription for each orderType (in table below). Each subscription is account global and each account can have multiple subscriptions per orderType.
Subscriptions contain the URL & CallbackCreds to authenticate and send number ordering & porting events for each state change.
Base Url
https://dashboard.bandwidth.com/api/accounts/{{accountId}}/subscriptions
Capabilities
| Verb | Path | about |
|---|---|---|
GET |
/api/accounts/{accountId}/subscriptions |
List all subscriptions |
POST |
/api/accounts/{accountId}/subscriptions |
Create an subscription |
GET |
/api/accounts/{accountId}/subscriptions/{subscriptionId} |
Get information about a specific subscription |
PUT |
/api/accounts/{accountId}/subscriptions/{subscriptionId} |
Make changes to an subscription |
DELETE |
/api/accounts/{accountId}/subscriptions/{subscriptionId} |
Delete an subscription |
Order Types
| Order type | Notified states |
|---|---|
portins |
PENDING_DOCUMENTS, SUBMITTED, FOC, REQUESTED_SUPP, COMPLETE, CANCELLED, EXCEPTION, REQUESTED_CANCEL |
orders |
COMPLETE, PARTIAL, BACKORDERED, FAILED |
portouts |
COMPLETE |
disconnects |
COMPLETE, PARTIAL, FAILED |
dldas |
RECEIVED, PROCESSING, COMPLETE, PARTIAL, FAILED |
lsrorders |
PENDING, FOC, EXCEPTION, COMPLETE, CANCELLED, PARTIAL, FAILED |
e911s |
RECEIVED, PROCESSING, COMPLETE, ADJUSTED_COMPLETE, PARTIAL, ADJUSTED_PARTIAL, FAILED |
tnoptions |
RECEIVED, PROCESSING, COMPLETE, PARTIAL, FAILED |
externalTns |
COMPLETE, PARTIAL, FAILED |
importtnorders |
COMPLETE, PARTIAL, FAILED, EXCEPTION |
lidb |
PROCESSING, COMPLETE, PARTIAL, FAILED |
bulkPortins |
DRAFT, IN_PROGRESS, NEEDS_ATTENTION, PARTIAL, COMPLETED, CANCELLED |