POST/v1/email/phone-validator

Phone Validator API

Validate and normalize any phone number.

Validate any phone number and normalize it into standard formats. Send a raw number with an optional country code and get back E.164, international, and local formats, plus line type, carrier, country code, timezone, and a validity flag — everything you need to clean and store phone data correctly.

Full Docs Get API Key — Free $5 Credit $0.01 / call

Try it live

Fill in the fields and hit Run to see a real response.

POST/v1/email/phone-validatorphone-validator$0.01/call

Response

Example response — hit "Send Request" to see a live result

{
  "data": {
    "carrier": null,
    "countryCode": "US",
    "e164Format": "+14155550132",
    "intlFormat": "+1 415-555-0132",
    "lineType": "FIXED_LINE_OR_MOBILE",
    "localFormat": "(415) 555-0132",
    "timezones": [
      "America/Los_Angeles"
    ],
    "valid": true
  },
  "ok": true
}

Features

✓

Validation and normalization together

One call confirms a number is valid and returns it in E.164, international, and local formats, so you clean and standardize phone data in a single step.

✓

Line type and carrier detection

Results include lineType and carrier so you can distinguish mobile from fixed lines and route SMS versus voice correctly.

✓

Country and timezone data

Each response carries the country code and timezones, letting you respect local calling windows and store geography-aware records.

✓

Country-code hint

Pass an optional country_code to disambiguate numbers written in national format for accurate parsing.

Use cases

Form Validation

Validate and normalize phone numbers at input to keep clean, dialable data in your database.

List Hygiene

Scrub and standardize an existing phone list, flagging invalid numbers before a campaign.

SMS Routing

Use line type and country to route SMS only to valid mobile numbers in the right regions.

Quick start

Copy this snippet and start making calls.

const res = await fetch('https://api.yepapi.com/v1/email/phone-validator', {
  method: 'POST',
  headers: {
    'x-api-key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "phone": "+14155550132",
    "country_code": "US"
  }),
});
const data = await res.json();
console.log(data);

The phone validation API — validate and normalize any number

The Phone Validator API checks whether a number is valid and returns it in E.164, international, and local formats, with line type, carrier, country code, and timezone. It's the clean-and-standardize step for any phone data you collect or import.

At $0.01 per call with $5 of free credit and no minimums, it's a simple pay-per-lookup way to keep phone fields dialable, all under the same YepAPI key that finds and enriches your contacts.

Start making API calls in 30 seconds

$5 free credit on signup. No credit card required. Pay per call.

Get API Key — Free $5 Credit

What developers say

“Switched from SerpAPI and cut our SERP costs by 80%. Same data quality, way simpler billing.”
Marcus T.
SEO Platform Founder

“One API key for AI models, SERP data, and web scraping. Saved us from managing 4 separate providers.”
Priya S.
Full-Stack Developer

“The $5 free credit let us prototype our entire rank tracking feature before committing. No other API does that.”
Jake R.
Indie Hacker

Frequently asked questions

Each API call costs $0.01. No monthly minimums or subscriptions — you only pay for what you use.

Sign up for a free API key, then send a POST request to /v1/email/phone-validator. Check the code example above for a ready-to-use snippet in JavaScript, cURL, or Python.

YepAPI bundles SEO, AI, and web scraping APIs under one key with no monthly minimums. You get lower per-call pricing, a unified dashboard, and one billing account instead of managing multiple providers.