WA Lookup

Result interpretation

What does a WhatsApp registration result mean?

A completed ws check reports whether the submitted phone number was registered on WhatsApp at the time of the request. Read registered separately from failed or undetermined requests: only completed checks provide a usable true or false result, and a new check is needed when you require a later status.

Use true as a point-in-time status

registered=true confirms the service reported a WhatsApp registration for that number during this check. It does not show activity, ownership, or permission to message.

Keep false separate from errors

registered=false is a completed result. A failed or undetermined request is not the same conclusion and is refunded rather than recorded as an unregistered number.

Use it for routing, not identity

Use the field to clean or route contact records. Do not treat registration alone as proof of the person or business behind the number.

Use the result well

Three details that make a single check useful

Send one phone number

Include the country code, for example +14155552671, so the request represents one clear identifier.

Read the selected fields

This service_type returns only its defined WhatsApp fields; select a different product when you need different fields.

Use the returned result

The backend returns the selected fields synchronously. Run a new check for an updated status, and obtain consent before contacting a person.

API contract

One request, immediate result

Read full API docs

Send one phone number and select this product with service_type. Authentication uses your API key.

RequestPOST /api/v1/check
{
  "service_type": "ws",
  "identifier": "+14155552671"
}
Response200 OK
{
  "code": 0,
  "msg": "ok",
  "data": {
    "service_type": "ws",
    "identifier": "+14155552671",
    "registered": true
  }
}

Product FAQ

Questions about Registration Check

What does WhatsApp Registration Check check?

It checks one phone number and returns registration status in the same synchronous response.

How does billing work for Registration Check?

Balance is charged only for completed checks. Failed or undetermined upstream requests do not keep the charge.

What should I submit?

Submit the phone number your workflow wants to check.

Does a registered result grant permission to contact someone?

No. It only reports the WhatsApp status fields available at the time of the check. You remain responsible for consent, recipient preferences, and applicable platform rules.

Related products

Choose the right product

ws_avatarWhatsApp Avatar CheckCheck registration, whether the WhatsApp account has set an avatar, and return the avatar URL when available.ws_businessWhatsApp Business Account CheckCheck registration and identify whether the number uses a WhatsApp Business account.