Skip to main content

Phone Number Lookup

GET 
/lookup/phone_number/:e164_number

This endpoint allows you to look up validity and formatting information about a number. You can optionally lookup additional information about the number such as carrier and caller ID data.

Permissions​

The API token must include the following scopes: Numbers.

Request​

Path Parameters

    e164_number stringrequired

    Number in E.164 format.

    Example: +15551234567

Query Parameters

    include string[]

    Possible values: [carrier, cnam]

    Further number information to include in the response, some of which are billable. You can specify:

    • carrier: Lookup full carrier information for the number.
    • cnam: Lookup Caller ID information for the number.

    Separate multiple values with a comma: include=carrier,cnam.

    Adding include=carrier to your request will do a live lookup to determine the current carrier information about this number. This includes more accurate information about what type of number as well as location. Only valid for numbers with a +1 country code.

    Adding include=cnam to your request will do a live lookup to determine the current caller ID information about this number. Only valid for numbers with a +1 country code.

    Example: carrier,cnam

Responses​

OK

Schema

    country_code_numbernumber

    The Country code associated with the number

    Example: 1
    national_numberstring

    Number in the countries national format.

    Example: 5551234567
    possible_numberboolean

    Whether the number supplied is a possible number. For example, in the United States +15551234567 is a possible number, but it is not a valid number.

    Example: true
    valid_numberboolean

    Whether the number supplied is a valid number.

    Example: true
    national_number_formattedstring

    The E164 number formatted in national format.

    Example: (555) 123-4567
    international_number_formattedstring

    The E164 number formatted in international format.

    Example: +1 555-123-4567
    e164string

    The number in E164 format.

    Example: +15551234567
    locationstring

    The location of the number based on its area code and NPA.

    Example: Texas
    country_codestring

    The ISO3166 alpha 2 country code associated with the number

    Example: US
    timezonesstring[]

    The time zones associated with the number

    Example: ["America/Austin"]
    number_typestring

    The type of number based on its area code and NPA. For more detailed record of number type, include carrier details in the request.

    Example: Fixed Line or Mobile

    carrier

    object

    Adding include=carrier to your request will do a live lookup to determine the current carrier information about this number. This includes more accurate information about what type of number as well as location.

    lrnstring

    The LRN associated with the number

    Example: 15551234567
    spidstring

    The Service Profile Identifier associated with the number

    Example: 683X
    ocnstring

    The Operating Company Number associated with the number

    Example: 12345
    latastring

    The Local Access and Transport Area number associated with the number

    Example: 99999
    citystring

    The City associated with the number

    Example: Aberdeen
    statestring

    The State/Province/Region associated with the number

    Example: WA
    jurisdictionstring

    The Jurisdiction associated with the number

    Example: indeterminate
    lecstring

    The LEC or Carrier of the number.

    Example: Verizon
    linetypestring

    The type of line the number is. Generally either wireless or landline

    Example: landline

    cnam

    object

    Adding include=cnam to your request will do a live lookup to determine the current caller ID information about this number.

    caller_idstring

    The caller ID associated with the number.

    Example: John Smith
Last updated on