Phone Number Active Status Checker

From Clearpath, creators of the WhatsApp Number Validator and Telegram Number Validator, with 11,000+ combined lifetime runs across those two actors. Bring the same team's phone-data tools to your call lists.

Why choose this actor?

• Check carrier status, not just number format. Get active, inactive or unknown for each checked mobile or landline number, alongside its normalized number, country code and check time. Separate inactive numbers from the contacts you want to keep.
• Process up to 100,000 unique numbers per run. Paste a list or upload CSV/XLSX. Automatic phone-column detection, number formatting and duplicate removal handle the cleanup. Real checks require at least 2,000 valid unique numbers and a paying Apify account.
• Export an active-only list. Enable onlyActiveNumbers to keep active numbers in your output, or retain all statuses for review. Download JSON, CSV or Excel to update your CRM or call list.

See the output before uploading your list

{
  "testMode": true
}

Open actor input and keep Test Mode enabled to inspect three fixed sample records. No real numbers are checked and no number-check events are charged. For a real batch, turn Test Mode off and provide 2,000–100,000 valid unique numbers. Set defaultCountryCode when your list uses national-format numbers.

unknown means the check was inconclusive. Active status does not guarantee that a call will be answered or a message delivered. Active-only filtering still bills every number checked. See pricing for current charges.

Clearpath · Phone & Account Intelligence
Phone Status You are here	WhatsApp Account checks	Telegram Account checks	Email Accounts Registration 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 checking real numbers:

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

Check a direct list (abbreviated below; real runs require at least 2,000 valid unique numbers):

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

Upload CSV/XLSX with at least 2,000 valid unique numbers 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 fixed sample output without real checks or number-check charges.
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.

See the Pricing tab for current plan-specific rates. Real checks require a paying Apify account.

Duplicates are removed before checking. Number-check charges apply to every number checked, including unknown results and numbers excluded by active-only filtering. Dataset-item and Actor-start charges are also shown in the Pricing tab.

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.

Q: My run failed and said none of my numbers were checked. What should I do? A: That is a temporary problem on our side, not a problem with your list. None of your numbers were checked, so none were charged. Leave your list as it is and start the run again in a few minutes.

Related Actors

More from Clearpath (Email tools):

• Email Account Checker - Check emails for real account registration on Gmail, Outlook, Yahoo, iCloud, Mail.ru.
• Email Address Validator - Bulk email deliverability validation (syntax, MX, SMTP, catch-all, disposable).
• Email Finder & Verifier - Find and verify B2B email addresses by name and domain.

---

📧 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.