Phone Number Active Status Checker

Check phone numbers in bulk for carrier-level active status.

The actor processes 2,000 to 100,000 unique numbers per run. Larger inputs are deduped, then trimmed to the first 100,000 unique normalized numbers. Each number returns one of three statuses: active, inactive, or unknown.

Use it to clean call lists, validate leads before outreach, reduce SMS bounce rates, and keep CRM phone data fresh.

Check up to 100,000 phone numbers per run for active, inactive, or unknown carrier status in one result file.

 

Clearpath Phone Intelligence   •  Bulk validation and profile enrichment for messaging platforms
WhatsApp Number Validator Bulk WhatsApp yes/no checks	Telegram Number Validator Bulk Telegram account checks	WhatsApp Profile Avatar API Avatar, age & gender enrichment	MAX Messenger Number Checker Bulk MAX account checks	Social & Crypto Number Checker 25-platform account checks

Copy to your AI assistant

clearpath/phone-number-active-checker on Apify. Bulk carrier-level phone status checks returning active, inactive, or unknown per number. Call ApifyClient("TOKEN").actor("clearpath/phone-number-active-checker").call(run_input={...}), then client.dataset(run["defaultDatasetId"]).list_items().items. Real runs need testMode=false and 2,000-100,000 unique numbers via phoneNumbers or csvFile. Full spec: GET https://api.apify.com/v2/acts/clearpath~phone-number-active-checker/builds/default (Bearer TOKEN) → inputSchema, actorDefinition.storages.dataset, readme. Token: https://console.apify.com/account/integrations

Quick Start

Preview sample output without charges:

{
  "testMode": true,
  "phoneNumbers": ["+14155552671"]
}

Check a direct list:

{
  "testMode": false,
  "phoneNumbers": [
    "+14155552671",
    "+442071234567"
  ],
  "onlyActiveNumbers": false
}

Upload CSV/XLSX and apply a default country code:

{
  "testMode": false,
  "csvFile": "uploaded-file.csv",
  "defaultCountryCode": "1",
  "onlyActiveNumbers": true
}

Input

For real runs, at least one of phoneNumbers or csvFile is required.

The actor is fully hosted on Apify. You provide phone numbers or an uploaded file; no extra credentials are required.

Parameter	Type	Description
testMode	boolean	Returns sample output without checking real numbers or charging credits.
phoneNumbers	array	Phone numbers with country code. Real runs require at least 2,000 unique numbers and process the first 100,000 after dedupe.
csvFile	string	Uploaded CSV or Excel file with phone numbers.
defaultCountryCode	string	Country code to prepend to numbers without a + prefix.
onlyActiveNumbers	boolean	Output only numbers where activeStatus is active.

CSV/Excel File Requirements

• Supported formats: .csv, .xlsx
• Delimiters: Comma, semicolon, tab, pipe (auto-detected)
• Column detection: Automatically finds phone columns including:
  • Standard: phone, mobile, cell, tel, telephone, whatsapp
  • Variations: phone number, mobile number, cell phone, contact number
  • CRM exports: mobile phone, direct phone, work phone, personal phone, primary phone
  • International: telefon, telefono, téléphone, celular, handy
• No headers? Scans content to find phone-like columns automatically

Output

{
  "phoneNumber": "+14155552671",
  "originalInput": "+1 415 555 2671",
  "countryCode": "US",
  "isValidFormat": true,
  "activeStatus": "active",
  "isActive": true,
  "checkedAt": "2026-06-09T08:00:00Z"
}

Output Fields

Field	Description
phoneNumber	Normalized E.164 phone number.
originalInput	Original value supplied by the user.
countryCode	Detected country code.
isValidFormat	Whether the number has a 7-15 digit format.
activeStatus	active, inactive, or unknown.
isActive	true when active, false when inactive, null when unknown.
checkedAt	ISO timestamp of the check.

Pricing

The actor uses pay-per-event pricing with one number_checked event per checked number.

Current planned rates per 1,000 checked numbers:

Plan	Price per 1,000
No subscription / Bronze	$11.99 / $9.90
Silver	$7.99
Gold and above	$6.99

Duplicates are removed before checking, so you pay for unique numbers checked.

Notes

• unknown means the status could not be determined for that number; it still counts as a checked number.
• Uploaded CSV/XLSX files can use common phone columns such as phone, mobile, or telephone.
• onlyActiveNumbers filters output rows, but billing still applies to every checked number.

---

FAQ

Q: How accurate are the results? A: Statuses reflect carrier-level reachability at the time of the check.

Q: What countries are supported? A: Worldwide. Numbers must include a country code, or set defaultCountryCode for national-format lists.

Q: How fast is it? A: A 2,000-number batch typically completes within a few minutes. Larger batches scale accordingly.

Q: What about duplicates? A: Auto-removed after normalization. You are only charged for unique numbers.

Q: What does unknown mean? A: The status could not be determined for that number. It still counts as a checked number.

Q: Is there a minimum batch size? A: Yes, 2,000 unique numbers per run. The maximum is 100,000.

---

📧 Support

• Email: max@mapa.slmail.me
• Feature Requests: Email or submit via issues
• Response Time: Typically within 24 hours

---

Legal

This actor checks carrier-level phone number status. Users are responsible for complying with applicable data protection regulations (GDPR, CCPA) when processing phone number lists.