WaConnect

API referenceContacts

Contacts

Look up phone numbers on WhatsApp.

Look up a phone number#

Checks whether a phone number has a WhatsApp account, asking WhatsApp through one of your connected numbers. Lookups are free.

POSThttps://api.waconnect.ai/v1/contacts/lookup
curl https://api.waconnect.ai/v1/contacts/lookup \
  -H "Authorization: Bearer wc_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"numberId":"YOUR_NUMBER_ID","phone":"+14155550123"}'

Body

numberIdstring (uuid)required
A connected number of yours.
phonestringrequired
The phone number in international format.
200 OKjson
{ "phone": "+14155550123", "onWhatsapp": true }

Response

phonestringrequired
The number, normalised to +countrycode format.
onWhatsappbooleanrequired
Whether the number has a WhatsApp account.
StatusWhy
400The phone number isn't in international format.
404The numberId doesn't belong to your business.
409That number isn't connected right now.
503WhatsApp didn't answer within 10 seconds — retry shortly.