Phone Number Validation Endpoint

On this page, we’ll dive into the phone number validation endpoint you can use to validate any given phone number and retrieve its carrier and location information.

GET/v1/info

Validate Phone Number

This phone validation endpoint provides information about carrier & location information.

Required attributes

  • Name
    phone_number
    Type
    string, path parameter
    Description

    The phone number you want to query (Either: including the country prefix, or without and you specify the country_code).

Optional attributes

  • Name
    country_code
    Type
    string
    Description

    An ISO Alpha 2 Country Code for the phone number (e.g. US). If you specify this parameter you do not need to prepend the country prefix

Possible line_type values

  • landline
  • mobile
  • satellite
  • paging
  • special_services
  • premium_rate
  • toll_free
  • N/A

Request

GET
/v1/info
curl -G https://api.numlookupapi.com/v1/validate/+14158586273 \
    -H "apikey: YOUR-API-KEY"

Full Response

{
    "valid": true,
    "number": "14158586273",
    "local_format": "4158586273",
    "international_format": "+14158586273",
    "country_prefix": "+1",
    "country_code": "US",
    "country_name": "United States of America",
    "location": "Novato",
    "carrier": "AT&T Mobility LLC",
    "line_type": "mobile"
}