WA Lookup

Avatar semantics

How should you interpret avatar and avatar_url?

A completed ws_avatar check returns registration status plus whether an avatar was available for the account, with avatar_url only when the service can return one. Treat these fields as point-in-time profile enrichment, not as proof that an account is active, trustworthy, or controlled by a particular person.

Read registered first

Use registered for WhatsApp registration status. avatar=false does not change the registration result and should never be interpreted as unregistered.

Treat avatar availability as changeable

Profile visibility and account settings can change. Store the check time and rerun the service when a current avatar decision matters.

Do not use the image as identity proof

An available avatar can enrich a record, but it does not verify the account owner, the image subject, or consent to reuse the image.

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_avatar",
  "identifier": "+14155552671"
}
Response200 OK
{
  "code": 0,
  "msg": "ok",
  "data": {
    "service_type": "ws_avatar",
    "identifier": "+14155552671",
    "registered": true,
    "avatar": true,
    "avatar_url": "https://pps.waavatar.xyz/v/example.jpg"
  }
}

Product FAQ

Questions about Avatar Check

What does WhatsApp Avatar Check check?

It checks one phone number and returns registration status, whether an avatar is set, and the avatar URL when available in the same synchronous response.

How does billing work for Avatar 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

wsWhatsApp Registration CheckConfirm whether a phone number is registered on WhatsApp.ws_businessWhatsApp Business Account CheckCheck registration and identify whether the number uses a WhatsApp Business account.