You have a list of phone numbers and no idea how many are actually on WhatsApp. Send to all of them and the dead ones fail, waste your budget, and can get your account flagged.
A WhatsApp number checker solves this before you send. This guide shows you, step by step, how to install my Tampermonkey script, format your numbers, run a check, and export the results. No API, no server, and no coding needed.
Why Invalid Numbers Hurt Your Outreach
Invalid numbers waste effort and put your account at risk. WhatsApp doesn't let you pre-filter a contact list, so every message to an unregistered number simply fails or goes unread.
The bigger danger is volume. Sending to many invalid numbers in a short window can trigger spam detection, which can restrict or ban the account. If 40% of your list is invalid, 40% of your outreach is wasted, and the other 60% is put at risk too.
What the WhatsApp Number Checker Does
The script checks each number on your list through WhatsApp Web and tells you whether it's registered. WhatsApp has no free public lookup API, so the check runs inside your own logged-in browser session instead. It works in three simple steps:
- Reads your list of numbers.
- Checks each one through a wa.me link.
- Writes the result (valid, invalid or rate-limited) with a timestamp to a table you can export as CSV.
You don't need Business API credentials or a server. The only thing you install is the free Tampermonkey extension.
What You Need Before You Start
Get these four things ready before you install anything. It takes about five minutes.
You need | Notes |
|---|---|
A WhatsApp account for checking | Not your primary business number. Use a spare one. |
Your phone list | A spreadsheet column or plain text, one number per line |
Chrome or Firefox | With the Tampermonkey extension (step 1 below) |
Your own compliance review | Read the WhatsApp Terms of Service and the data-protection rules that apply to you |
How to Install the Script
Installing takes three steps and works the same in Chrome and Firefox. You only do this once.
- Install Tampermonkey. Go to tampermonkey.net, pick your browser, and click Add to Chrome (or Add to Firefox).
- Install the checker script. Open the WhatsApp number checker script. Tampermonkey shows an install page. Click Install.
- Confirm it's on. Click the Tampermonkey icon, open Dashboard, and check that the script's toggle is green.
That's it. Next, get your number list into the right format.
How to Format Your Numbers
Every number must be in E.164 format: a plus sign, the country code, then the number. Local formats produce false "invalid" results, which is one of the two most common reasons a check goes wrong.
Your list says | Change it to |
|---|---|
07911123456 (UK local) | +447911123456 |
(415) 555-2671 (US local) | +14155552671 |
The script normalizes local formats first, but a clean list gives the most reliable results. Remove spaces, dashes and brackets, drop the leading 0, and add the country code. See this E.164 explainer for more examples.
How to Run a Check and Export Results
Running a check takes four steps once the script is installed. Keep the WhatsApp Web tab open until the run ends.
- Open web.whatsapp.com and scan the QR code with the phone that holds your checking account.
- Reload the page. The checker panel appears.
- Paste your numbers into the box and click start. The script waits a configurable delay between checks, typically 3–8 seconds.
- When it finishes, click export to download the results as a CSV.
Plan your time around the delay. At 5 seconds per number you check about 720 numbers per hour, so a list of a few hundred finishes in under an hour.
When the Checker Fails: Edge Cases and Fixes
Five things can go wrong, and rate limiting and format errors are the two most common. Each one has a fix built into the script or into how you run it.
Problem | What you'll see | Fix |
|---|---|---|
Rate limiting | Results marked rate-limited, or checks slow down | Randomized delays and batch pausing. Increase the delay if it keeps happening. |
Mixed number formats | Real numbers marked invalid | Convert to E.164 first (see above) |
Privacy-restricted accounts | Limited information on some numbers | Nothing to fix. The script can only show what WhatsApp allows. |
Session expiration (QR login timeout) | The check stops partway | The script detects the logout. Scan the QR code again and continue. |
Large lists | Very long runs | Checkpoint saves let you resume after a crash instead of starting over |
Large lists need the most planning. Checking 10,000 numbers at 5 seconds each takes about 14 hours, so let checkpoints and batch pauses do the work across sessions.
Frequently Asked Questions
How does a WhatsApp number checker work without an API?
It runs inside WhatsApp Web in your own browser. For each number, the script opens a wa.me link and reads whether WhatsApp recognizes it, then logs the result as valid, invalid or rate-limited. You need no API key, no Business API credentials and no server, only the free Tampermonkey extension in Chrome or Firefox.
Can the script check numbers in bulk?
Yes, with delays between checks. At about 720 numbers per hour on a 5-second delay, a list of a few hundred finishes in under an hour. Larger lists use batch pausing to avoid rate limits and checkpoint saves so you can resume, which matters for something like 10,000 numbers at about 14 hours.
Do I need a WhatsApp Business account?
No. A normal WhatsApp account is enough, because the script works through WhatsApp Web like any user would. Use a spare account rather than your primary business number, though. Sending to many invalid numbers quickly can trigger spam detection, and you don't want that risk landing on the number your customers know.
Is using a WhatsApp number checker legally permitted?
That decision is yours. Whether your use complies depends on WhatsApp's Terms of Service and the data-protection laws where you and your contacts are. Review both before running a check, and make sure you have a lawful basis for contacting the people on your list. If you're unsure, ask a legal adviser.
Want It Built to Your Spec?
I build this kind of thing for a living, including custom delays, input formats and export columns for your list. Order a custom WhatsApp number checker built to your specification. Scoping is free, and you get an approach, timeline and fixed quote.