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

results matching ""

    No results matching ""