WhatsApp number check API: is this number on WhatsApp?

Updated 2026-09-29

A WhatsApp number check answers one question: does this phone number have a WhatsApp account? The Digital Footprint API answers it in one request, alongside Telegram and any of the other messaging and social platforms a number can be checked on (WhatsApp, Telegram, Facebook, Instagram and X (Twitter)). Each platform is priced separately and only billed when it runs, and the same call can return the carrier, line type and a phone risk score.

Check a number on WhatsApp and Telegram in one request

Send the number in E.164 form. With no platforms named, the default set runs - WhatsApp and Telegram - and each comes back as one row with registered and checkedAt.

POST /v2/footprint
curl -X POST "https://api.digifootprint.dev/v2/footprint" \
  -H "Authorization: Bearer dfp_your_key" \
  -H "Content-Type: application/json" \
  -d '{"phone": "+14155552671"}'
Response (abridged)
{
  "lookupId": "5c1e0a7b-...",
  "footprint": {
    "platformsChecked": 2,
    "matches": 2,
    "results": [
      { "platform": "whatsapp", "registered": true, "identity": "phone", "checkedAt": "2026-09-29T10:14:02.118Z" },
      { "platform": "telegram", "registered": true, "identity": "phone", "checkedAt": "2026-09-29T10:14:02.964Z" }
    ]
  }
}

Choose which platforms to check

A phone number can be checked on WhatsApp, Telegram, Facebook, Instagram and X (Twitter). Name exactly the ones you need and only those run - and only those are billed. Leave the list out and the default set runs.

Request body
{
  "phone": "+14155552671",
  "checks": { "footprint": { "phone": { "platforms": ["whatsapp", "telegram", "facebook"] } } }
}

Per-platform prices for every plan are on the rate card, and the estimator works out a monthly bill from your volume.

Fast answers without paying for the long tail

On POST /v2/lookup, set checks.footprint.early and the platforms run one at a time, in the order you named them, stopping as soon as enough accounts are found or the time budget runs out. Platforms that never ran are refunded automatically, so an early answer costs less than a full sweep rather than the same.

Why a WhatsApp check matters for fraud and onboarding

A mobile number that has had a WhatsApp or Telegram account is a number somebody actually uses. A freshly issued VOIP number with no messaging account anywhere is a very different profile - common behind bonus abuse, fake accounts and mule accounts. Pair the platform check with the phone intelligence module (validity, carrier, line type, VOIP class, SIM swap on higher plans) and the phone risk score reads both together, with every fired signal named so a reviewer can see why.

Acceptable use

The check confirms whether an account exists for a number that a person gave you or that is already part of a case - for signup risk, KYC and fraud prevention. It returns no account contents, and it is not for locating or monitoring people. Our terms say so, and our privacy policy covers removal requests.

Frequently asked questions

How do I check if a phone number is on WhatsApp with an API?
Send the number in international format to POST /v2/footprint or POST /v2/lookup on api.digifootprint.dev. The response lists WhatsApp with registered true or false and the time it was checked. WhatsApp and Telegram run by default; other platforms are named in checks.footprint.phone.platforms.
Can the same API check Telegram, Facebook, Instagram and X by phone number?
Yes. A phone number can currently be checked on WhatsApp, Telegram, Facebook, Instagram and X (Twitter). Name the ones you want in checks.footprint.phone.platforms, or send nothing and the default set runs. An unknown platform name is rejected with a 400 rather than silently skipped.
How much does a WhatsApp number check cost?
A phone number is priced per platform checked, and the price of each platform is listed on the public rate card at /pricing/rates. A platform that did not run - because an early answer was already enough, for example - is never billed. There are free lookups to start, with no card required.
Does a WhatsApp number check show the profile name or photo?
No. The WhatsApp number check returns whether an account exists for the number and when that was established. Names, photos, status text and message content are never returned, from WhatsApp or any other platform.
What if WhatsApp cannot be checked for a number?
Then WhatsApp is left out of the results rather than reported as not registered. A missing answer and a confirmed no are different facts, and the API never turns the first into the second.

Related

Start freeTry a lookup