Skip to main content
POST
Verificar números
POST /contact/check Verifique quais números possuem conta no WhatsApp antes de disparar mensagens. Ideal para higienizar listas e evitar envios para números inválidos.
Limite diário (anti-ban): o plano free permite 20 verificações por dia, contadas por número. Ao estourar, a requisição inteira é rejeitada com 429 e a mensagem informa quantas restam. Planos pagos possuem limites maiores. Máximo de 50 números por requisição.
Cada item de results traz { phone, exists, jid, lid }, onde phone é exatamente o número enviado e jid/lid só vêm preenchidos quando exists é true.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
sessionId
string
required

ID externo de uma sessão conectada.

phones
string[]
required

Lista de números com DDI (formato E.164 sem o '+', 6 a 15 dígitos). Não aceita groupId (@g.us). Máximo de 50 por requisição.

Required array length: 1 - 50 elements
Example:

Response

Resultado da verificação.

success
boolean
results
object[]
summary
object