Rate Limits for Number & Account Management
Bandwidth implements Ratelimits for our number ordering and account management APIs
Sample Rate Limit Response (HTTP-429)
BaseURL: https://dashboard.bandwidth.com/api/
When a rate limit is hit for endpoints on the https://dashboard.bandwidth.com/api/ API Bandwidth will respond with a HTTP-429 error indicating that the limit has been reached.
The response includes a X-RateLimit-Reset header value with the epoch time in seconds when the limit will reset. Bandwidth recommends waiting until the reset-time has been reached wait_in_seconds(resetTime - currentTime); before sending any new requests to the same endpoint.
HTTP/1.1 429
X-RateLimit-Reset: 1590033530
Date: Thu, 21 May 2020 03:57:36 GMT
Content-Length: 0
Connection: close
List of Ratelimited endpoints
ORDER
Endpoints related to creating & updating Orders.
| Method | Path |
|---|---|
POST |
/accounts/{accountId}/orders |
PUT |
/accounts/{accountId}/orders/{orderId} |
SEARCH
Endpoints related to searching and pulling information.
| Method | Path |
|---|---|
GET |
/accounts/{accountId}/csrs |
GET |
/cities |
GET |
/rateCenters |
GET |
/accounts/{accountId}/availableNumbers |
GET |
/accounts/{accountId}/emergencyNotificationGroupOrders |
GET |
/accounts/{accountId}/bulkPortins |
GET |
/accounts/{accountId}/bulkPortins/{orderId} |
MOVE_TNS
Endpoints related to phone number management. Specifically moving a batch of phone numbers from one SIPPEER to another.
| Method | Path |
|---|---|
POST |
/accounts/{accountId}/sites/{siteId}/sippeers/{sipPeerId}/movetns |
DISCONNECT
Endpoints related to disconnecting a phone number.
| Method | Path |
|---|---|
POST |
/accounts/{accountId}/disconnects |
IMPORT_ACCOUNT
Endpoints related to importing phone numbers for use with Hosted Messaging.
| Method | Path |
|---|---|
POST |
/accounts/{accountid}/importToAccount |
PORT_IN
Endpoints related to creating and managing Portins
| Method | Path |
|---|---|
POST |
/accounts/{accountId}/portins |
PUT |
/accounts/{accountId}/portins/{orderid} |
DELETE |
/accounts/{accountId}/portins/{orderid} |
GET |
/accounts/{accountId}/portins/availabilityCheck/{telephonenumber} |
POST |
/accounts/{accountId}/lnpchecker |
BULK_PORT_IN
Endpoints related to creating and managing Bulk Port orders.
| Method | Path |
|---|---|
GET |
/bulkPortins/{orderId} |
POST |
/accounts/{accountId}/bulkportins |
PUT |
/accounts/{accountId}/bulkportins/{orderId} |
PATCH |
/accounts/{accountId}/bulkportins/{orderId} |
DELETE |
/accounts/{accountId}/bulkportins/{orderId} |
GET |
/accounts/{accountId}/bulkportins/{orderId}/portinList |
PUT |
/accounts/{accountId}/bulkportins/{orderId}/portinList |
PUT |
/accounts/{accountId}/bulkportins/{orderid}/{tnList} |
GET |
/accounts/{accountId}/bulkportins/{orderid}/{tnList} |
PORT_OUT
Endpoints related to creating and managing Portouts
| Method | Path |
|---|---|
POST |
/accounts/{accountId}/portouts |
PUT |
/accounts/{accountId}/portouts |
PUT |
/accounts/{accountId}/portouts/{orderId} |
DELETE |
/accounts/{accountId}/portouts |
SUBSCRIPTION
Endpoints related to creating and managing Subscriptions.
| Method | Path |
|---|---|
POST |
/accounts/{accountId}/subscriptions |
PATCH |
/accounts/{accountId}/subscriptions/{subscriptionId} |
DELETE |
/accounts/{accountId}/subscriptions/{subscriptionId} |
GET |
/accounts/{accountId}/subscriptions |
GET |
/accounts/{accountId}/subscriptions/{subscriptionId} |
COVERED_RATECENTERS
Endpoints related to getting information about Rate Centers.
| Method | Path |
|---|---|
GET |
/coveredRateCenters |
GET |
/coveredRateCenters/{coveredRateCenterId} |
REPORTS
Endpoints related to generating reports.
| Method | Path |
|---|---|
POST |
/reports/{reportId}/instances |
POST |
/accounts/{accountId}/reports/{reportid}/instances |
AVAILABLE_NPANXX
Endpoints related to searching for rate centers and phone numbers.
| Method | Path |
|---|---|
GET |
/availableNumbers |
GET |
/availableNumbers/totals |
GET |
/accounts/{accountId}/availableNpaNxx |
INSERVICE_NPANXX
Endpoints related to pulling information about active phone numbers on an account.
| Method | Path |
|---|---|
GET |
/accounts/{accountId}/inserviceNumbers |
GET |
/accounts/{accountId}/sites/{siteId}/inserviceNumbers |
GET |
/accounts/{accountId}/inserviceNumbers/totals |
GET |
/accounts/{accountId}/inserviceNumbers/{telephoneNumber} |
EVS_GEOCODING
Endpoints related to creating a geoCoded response for the e911 services.
| Method | Path |
|---|---|
POST |
/accounts/{accountId}/geocodeRequest |
E911_ORDER
Endpoints related to creating an e911 Order.
| Method | Path |
|---|---|
POST |
/accounts/{accountId}/e911s |
SEARCH_TYPEAHEAD
| Method | Path |
|---|---|
GET |
/typeahead |
HISTORY
Endpoints related to pulling historical information.
| Method | Path |
|---|---|
GET |
/portins |
GET |
/portins/{orderId} |
GET |
/portins/{orderId}/history |
GET |
/accounts/{accountId}/orders |
GET |
/accounts/{accountId}/sites/{siteId}/orders |
GET |
/accounts/{accountId}/orders/totals |
GET |
/accounts/{accountId}/orders/{orderId} |
GET |
/accounts/{accountId}/sites/{siteId}/orders/{orderId} |
GET |
/accounts/{accountId}/sites/{siteId}/orders/{orderId}/tns |
GET |
/accounts/{accountId}/orders/{orderId}/history |
GET |
/accounts/{accountId}/orders/{orderId}/totals |
GET |
/accounts/{accountId}/orders/{orderId}/tns |
GET |
/accounts/{accountId}/orders/{orderId}/areaCodes |
GET |
/accounts/{accountId}/orders/{orderId}/npaNxx |
GET |
tns/{fullnumber} |
GET |
tns/{fullnumber}/ratecenter |
GET |
tns/{fullnumber}/lata |
GET |
/accounts/{accountId}/disconnects |
GET |
/accounts/{accountId}/disconnects/{orderId} |
GET |
/accounts/{accountId}/importToAccount/{orderid} |
GET |
/accounts/{accountId}/importToAccount/batches |
GET |
/accounts/{accountId}/importToAccount/batches/{batchId} |
GET |
/accounts/{accountId}/importToAccount |
GET |
/accounts/{accountId}/portins |
GET |
/accounts/{accountId}/portins/{orderid} |
GET |
/accounts/{accountId}/portins/totals |
GET |
/accounts/{accountId}/portins/status |
GET |
/accounts/{accountId}/portins/{orderid}/totals |
GET |
/accounts/{accountId}/portins/{orderid}/areaCodes |
GET |
/accounts/{accountId}/portins/{orderid}/npaNxx |
GET |
/accounts/{accountId}/portins/{orderid}/tns |
GET |
/accounts/{accountId}/portins/{orderid}/history |
GET |
/accounts/{accountId}/portouts |
GET |
/accounts/{accountId}/portouts/{orderid} |
GET |
/accounts/{accountId}/portouts/totals |
GET |
/accounts/{accountId}/portouts/status |
GET |
/accounts/{accountId}/sites/{siteId}/portins |
GET |
/bulkPortins |
GET |
/accounts/{accountId}/bulkPortins/{orderId}/{history |
GET |
/accounts/{accountId}/e911s/{orderId}/history |
GET |
/accounts/{accountId}/e911s |
GET |
/accounts/{accountId}/e911s/{orderId} |