WA Lookup

API contract

One request, immediate result

Read full API docs Open API Keys

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

Copy the curl command below and replace only the example API key with your own.

cURL requestPOST /api/v1/check
curl -X POST "https://walookup.com/api/v1/check" \
  -H "X-API-Key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{ "service_type": "ws_avatar", "identifier": "+17253100591" }'
Response200 OK
{
  "code": 0,
  "msg": "ok",
  "data": {
    "service_type": "ws_avatar",
    "identifier": "+17253100591",
    "registered": true,
    "avatar": true,
    "avatar_url": "<image url>"
  }
}

How to use it

Three steps in one realtime check

  1. Send one number

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

  2. Read the selected fields

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

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

Product FAQ

Questions about Avatar Check

What does WhatsApp Avatar Check check?

It checks one number and returns registration status, avatar availability, and the avatar URL field in the same synchronous response.

How does billing work for Avatar Check?

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

What should I submit?

Submit one number in E.164 format, including the country code — for example +17253100591.

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

Other WhatsApp check products

WhatsApp Registration CheckConfirm whether a number is registered on WhatsApp — useful for checking a contact list before you send.WhatsApp Business Account CheckCheck registration and identify whether the number uses a WhatsApp Business account.