Skip to content
Gridlode
LiveContacts and enrichment1 credit / request

Phone Validator API

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.

GEThttps://api.gridlode.com/v1/contacts/phone
Get an API keyReference docs

Try it live

Try . Free, no account needed.

Parameters

NameTypeDescription
phonerequiredstringPhone number in any common format, e.g. +1 650-253-0000 or (650) 253-0000.
countrystringDefault region as an ISO 3166 alpha-2 code (e.g. US, GB), used when the number has no +country prefix.
Default: null
max_ageintegerAccept a cached answer up to this many seconds old, billed at 50%. Default 0 (always fresh).

Response fields

    Code

    curl "https://api.gridlode.com/v1/contacts/phone?phone=%2B1%20650-253-0000" \
  -H "Authorization: Bearer $GRIDLODE_KEY"
    1 credit per request
    One credit is $0.001 on the smallest pack, from $0.0003 on enterprise plans.
    Half price for cached data
    Cached for up to 24 h. Pass max_age to use it.
    Failed requests are free
    Blocks, timeouts and target errors never cost credits.

    Market reference: Outscraper phone $5 → $3 per 1k.

    Questions

    Part of these solutions
    How much does the Phone Validator API cost?

    1 credit per request. One credit costs $0.001 on the smallest pack and as little as $0.0003 on enterprise plans. Cached answers cost half and failed calls are free.

    Contacts and enrichment

    Related APIs in this category

    All 6 in Contacts and enrichment · 6 live
    Live

    Company Enrichment

    One call turns a domain or a company name into a company profile

    6 credits / requestDocs
    Live

    Emails & Contacts from Website

    Crawls a business website's home page plus up to four contact, about, imprint or legal pages and returns the emails (including Cloudflare-protected…

    2 credits / requestTry freeDocs
    Live

    Email Finder

    Likely work email addresses for a person at a company, from their name and the company domain

    5 credits / requestDocs