# Phone Number Validator API - Format, Country & Mobile Check (`sndzcc/phone-number-validator`) Actor

Validate and clean phone numbers in bulk: valid or not, E.164 and international format, country, region, mobile or landline, carrier, time zone and WhatsApp link. Paste a list, a CSV link or any text.

- **URL**: https://apify.com/sndzcc/phone-number-validator.md
- **Developed by:** [Sndz Data](https://apify.com/sndzcc) (community)
- **Categories:** Lead generation, Developer tools
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.50 / 1,000 phone numbers

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Phone Number Validator API: Format, Country & Mobile Check

**Validate and clean phone numbers in bulk.** For every number you get whether it's **valid**, its **E.164**, international and national formats, **country**, region, **mobile or landline**, carrier, time zone and a **WhatsApp link** for mobiles. Paste a list, link a CSV or Google Sheet, or paste any text and the numbers inside are found for you.

Uses Google's libphonenumber rules for 240+ countries. No API key, and numbers never leave the run.

### Why this one?

- **Bulk:** thousands of numbers per run, in any format.
- **Clean CRM data:** E.164 output ready for Twilio, WhatsApp, HubSpot or Salesforce.
- **Mobile or landline,** so you only send SMS or WhatsApp to mobiles.
- **CSV and Google Sheets** input, and numbers found inside free text.
- **Cheap:** $0.50 per 1,000 numbers, and invalid ones are free if you keep only valid numbers.

### Use cases

- **Clean lead lists** before importing them into your CRM or dialer.
- **SMS and WhatsApp campaigns:** keep only valid mobiles, formatted correctly.
- **Sign-up forms:** check numbers your users typed.
- **Scraped data:** normalize phones found on websites (pairs well with our Email & Contact Scraper).

### Input

| Field | What it does |
|---|---|
| **Phone numbers** | One per line, any format. |
| **Default country** | For numbers without +country code (US, ES, GB, MX...). |
| **CSV file link** | A public CSV or published Google Sheet. |
| **Find numbers in text** | Extracts numbers from pasted text. |
| **Only valid numbers** | Skip (and don't pay for) invalid ones. |
| **Remove duplicates** | Same number, different formats: one row. |

```json
{
  "phoneNumbers": ["+34 612 345 678", "(415) 555-2671"],
  "defaultCountry": "US"
}
```

### Output

```json
{
  "input": "+34 612 345 678",
  "valid": true,
  "e164": "+34612345678",
  "international": "+34 612 34 56 78",
  "national": "612 34 56 78",
  "countryCode": 34,
  "country": "ES",
  "location": "Spain",
  "type": "mobile",
  "isMobile": true,
  "carrier": "Syma",
  "timezones": ["Atlantic/Canary", "Europe/Madrid"],
  "whatsappLink": "https://wa.me/34612345678"
}
```

### Good to know

- "Valid" means the number follows the numbering plan of its country (right length and prefixes). It doesn't call the number, so it can't tell whether the line is currently active.
- Carrier is the original operator of the number range; numbers ported to another operator keep the original carrier name.

### Integrations

Validate new leads automatically from Google Sheets, HubSpot, Make, Zapier or n8n.

### How to use it

1. Click **Try for free** (or **Start**) at the top of this page.
2. Fill in the input, or keep the example to see it working in seconds.
3. Click **Start** and wait for the run to finish.
4. Download the results as **Excel, CSV, JSON or HTML**, or get them through the Apify API.

### How much does it cost?

**$0.0005 per phone number** ($0.50 per 1,000). No start fee, no monthly fee, and you only pay for the results saved to your dataset.

| Example | Cost |
|---|---|
| Clean a list of 1,000 leads | about $0.50 |
| Validate 20,000 CRM contacts | about $10.00 |

Apify's free plan includes monthly credit, so you can try it for free.

### FAQ

**What does valid mean?**

The number follows its country's numbering plan (length and prefixes). It doesn't call the line.

**Can it tell mobile from landline?**

Yes, for most countries, plus the original carrier and time zone.

**Which formats does it output?**

E.164 (+34612345678), international and national formats, plus a WhatsApp link for mobiles.

**Can I upload a spreadsheet?**

Yes. Link a public CSV or a Google Sheet published as CSV; the phone column is found automatically.

### More tools from Sndz Data

- [BORME Scraper API - Spain New Company Leads Daily](https://apify.com/sndzcc/borme-spain-companies): every new company registered in Spain, daily
- [App Store & Google Play Reviews Scraper API](https://apify.com/sndzcc/app-reviews-scraper): App Store and Google Play reviews in one run
- [Job Scraper API - Greenhouse, Lever, Ashby & Workable](https://apify.com/sndzcc/ats-jobs-scraper): all open jobs from Greenhouse, Lever, Ashby and more
- [Google News Scraper API - Articles with Real URLs](https://apify.com/sndzcc/google-news-scraper): news by keyword or topic, with real article URLs
- [Email & Contact Scraper API - Emails, Phones & Socials](https://apify.com/sndzcc/contact-details-scraper): emails, phones and social profiles from any website
- [Telegram Scraper API - Channel Posts, Views & Media](https://apify.com/sndzcc/telegram-channel-scraper): posts, views and media from public Telegram channels
- [Brand Monitoring API - Mentions Radar for News & Reddit](https://apify.com/sndzcc/brand-mentions-radar): brand mentions across 9 sources, with sentiment
- [AI Image Upscaler API - Upscale & Enhance Photos 4x](https://apify.com/sndzcc/ai-image-upscaler): upscale and enhance photos 4x with AI
- [Keyword Research API - Google, YouTube & Amazon Ideas](https://apify.com/sndzcc/keyword-ideas-machine): hundreds of keyword ideas from 5 search engines
- [Tech Stack Detector API - Wappalyzer & BuiltWith Alternative](https://apify.com/sndzcc/tech-stack-detector): the technologies behind any website, in bulk
- [Polymarket & Kalshi API - Prediction Market Odds](https://apify.com/sndzcc/prediction-markets-scraper): live odds from Polymarket and Kalshi in one dataset
- [WHOIS & Domain Lookup API - DNS, SSL & Availability](https://apify.com/sndzcc/domain-intel): WHOIS, availability, DNS and SSL for any list of domains
- [Bluesky Scraper API - Posts, Profiles & Followers](https://apify.com/sndzcc/bluesky-scraper): posts, profiles and followers from Bluesky, no login
- [SEO Audit API - Broken Links, Meta Tags & Site Crawler](https://apify.com/sndzcc/seo-audit): SEO audit and broken link checker for any website
- [OCR API - Image & PDF to Text Extractor, 100+ Languages](https://apify.com/sndzcc/image-pdf-to-text): text from images and scanned PDFs, 100+ languages
- [Podcast Transcription API - Whisper Speech to Text & SRT](https://apify.com/sndzcc/speech-to-text): audio, video and podcasts to text and subtitles with Whisper AI
- [Website Screenshot API - Full Page, Mobile & PDF Capture](https://apify.com/sndzcc/website-screenshot): full-page, mobile and PDF screenshots of any website
- [Remote Jobs Scraper API - 6 Job Boards in One](https://apify.com/sndzcc/remote-jobs-scraper): remote jobs from 6 job boards in one dataset
- [Substack Scraper API - Newsletter Posts, Stats & Full Text](https://apify.com/sndzcc/substack-scraper): posts, engagement and full text from any Substack
- [Y Combinator Companies Scraper API - Startups & Founders](https://apify.com/sndzcc/yc-companies-scraper): every YC startup with its founders and LinkedIn links

### Support

Need another field? Open an issue on the **Issues** tab.

If this Actor saves you time, a quick ⭐ review helps a lot and keeps it maintained. Thank you!

# Actor input Schema

## `phoneNumbers` (type: `array`):

One per line, in any format: +34 612 345 678, (415) 555-2671, 0044 20 7946 0018...

## `defaultCountry` (type: `string`):

Two-letter code (US, ES, GB, MX, DE...) for numbers written without +country code.

## `csvUrl` (type: `string`):

A public CSV link (Google Sheets: File > Share > Publish to web > CSV). The phone column is found automatically.

## `csvColumn` (type: `string`):

Name of the column with the numbers, if it isn't detected.

## `text` (type: `string`):

Paste emails, signatures or notes: every phone number inside is extracted and checked.

## `onlyValid` (type: `boolean`):

Skip invalid numbers (you don't pay for them).

## `removeDuplicates` (type: `boolean`):

The same number written in different ways appears once.

## Actor input object example

```json
{
  "phoneNumbers": [
    "+34 612 345 678",
    "(415) 555-2671",
    "+44 20 7946 0018",
    "12345"
  ],
  "defaultCountry": "US",
  "onlyValid": false,
  "removeDuplicates": true
}
```

# Actor output Schema

## `overview` (type: `string`):

One row per number: valid, formats, country, type and carrier.

## `allData` (type: `string`):

Every field, including national format, time zones and WhatsApp link.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "phoneNumbers": [
        "+34 612 345 678",
        "(415) 555-2671",
        "+44 20 7946 0018",
        "12345"
    ],
    "defaultCountry": "US"
};

// Run the Actor and wait for it to finish
const run = await client.actor("sndzcc/phone-number-validator").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "phoneNumbers": [
        "+34 612 345 678",
        "(415) 555-2671",
        "+44 20 7946 0018",
        "12345",
    ],
    "defaultCountry": "US",
}

# Run the Actor and wait for it to finish
run = client.actor("sndzcc/phone-number-validator").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "phoneNumbers": [
    "+34 612 345 678",
    "(415) 555-2671",
    "+44 20 7946 0018",
    "12345"
  ],
  "defaultCountry": "US"
}' |
apify call sndzcc/phone-number-validator --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,sndzcc/phone-number-validator"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/hO2m47qgFUIPT3gRn/builds/YHNcFvagCXDywXX6F/openapi.json
