Skip to main content
Version: v0.31.0

Check if a phone number exists on WhatsApp

GET 

/api/sessions/:sessionId/contacts/check/:number

Returns whether the number is a registered WhatsApp account and its canonical id. Use this to pre-validate a recipient before sending. Only the digits of number are queried, so a +, spaces or an @c.us suffix are tolerated. Baileys also checks unmapped phone destinations before sending: a number reported as unregistered is rejected with 400. A successful check does not confirm message delivery. Requires an OPERATOR key.

Request​

Responses​

Number existence check result