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_number number

    The Country code associated with the number

    Example: 1
    national_number string

    Number in the countries national format.

    Example: 5551234567
    possible_number boolean

    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_number boolean

    Whether the number supplied is a valid number.

    Example: true
    national_number_formatted string

    The E164 number formatted in national format.

    Example: (555) 123-4567
    international_number_formatted string

    The E164 number formatted in international format.

    Example: +1 555-123-4567
    e164 string

    The number in E164 format.

    Example: +15551234567
    location string

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

    Example: Texas
    country_code string

    The ISO3166 alpha 2 country code associated with the number

    Example: US
    timezones string[]

    The time zones associated with the number

    Example: ["America/Austin"]
    number_type string

    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.

    lrn string

    The LRN associated with the number

    Example: 15551234567
    spid string

    The Service Profile Identifier associated with the number

    Example: 683X
    ocn string

    The Operating Company Number associated with the number

    Example: 12345
    lata string

    The Local Access and Transport Area number associated with the number

    Example: 99999
    city string

    The City associated with the number

    Example: Aberdeen
    state string

    The State/Province/Region associated with the number

    Example: WA
    jurisdiction string

    The Jurisdiction associated with the number

    Example: indeterminate
    lec string

    The LEC or Carrier of the number.

    Example: Verizon
    linetype string

    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_id string

    The caller ID associated with the number.

    Example: John Smith