Number Lookup Service

A guide that walks through the Bandwidth API to provide carrier information for a telephone number or batch of telephone numbers.

Currently, this service supports lookups of telephone numbers in the mainland United States, Alaska, Hawaii, District of Columbia, and the provinces of Canada. Telephone numbers submitted must be in E.164 format to be processed.

Submit Number Lookup Order#

Request URL#

POST https://numbers.bandwidth.com/api/v1/accounts/{accountId}/tnlookup

Examples#

Single Number Lookup
Multiple Number Lookup

Request

POST https://numbers.bandwidth.com/api/v1/accounts/{accountId}/tnlookup HTTP/1.1
Content-Type: application/json
Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=

{
  "tns": [
    "19196104423"
  ]
}

Response

HTTP 202 Accepted
Content-Type: application/json
Location: https://numbers.bandwidth.com/api/v1/accounts/9999999/tnlookup/004223a0-8b17-41b1-bf81-20732adf5590

{
  "requestId": "004223a0-8b17-41b1-bf81-20732adf5590",
  "status": "IN_PROGRESS"
}

Fetch Order Information#

Request URL#

GET https://numbers.bandwidth.com/api/v1/accounts/{accountId}/tnlookup/{orderId}

Examples#

Request

GET https://numbers.bandwidth.com/api/v1/accounts/{accountId}/tnlookup/{orderId} HTTP/1.1
Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=

Response

HTTP/1.1 200 OK
Content-Type: application/json

{
  "requestId": "004223a0-8b17-41b1-bf81-20732adf5590",
  "status": "IN_PROGRESS"
}