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}

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

results matching ""

    No results matching ""