Skip to content
Gridlode
Docs · Reference

Phone Validator

GET /v1/contacts/phone1 credit / requestcache 1440 min

Validates and formats a phone number from any country: valid and possible flags, E.164, international and national formats, country calling code, region, line type (mobile, fixed line, toll free, VoIP and more), the original carrier, location and time zones. Computed from Google's libphonenumber data with no network calls. The carrier is the network the number range was first assigned to; ported numbers may now be on a different carrier.

Query parameters

phone
string · required
Phone number in any common format, e.g. +1 650-253-0000 or (650) 253-0000.
country
string
Default region as an ISO 3166 alpha-2 code (e.g. US, GB), used when the number has no +country prefix.
Default: null
max_age
integer
Accept a cached answer up to this many seconds old, billed at 50%.

Response data fields

    Example

    curl "https://api.gridlode.com/v1/contacts/phone?phone=%2B1%20650-253-0000" \
  -H "Authorization: Bearer $GRIDLODE_KEY"

    Try it without code on the Phone Validator API page.