Skip to main content
POST
https://api.oxenty.api.br
/
api
/
contacts
/
check
curl -X POST "https://api.oxenty.api.br/api/contacts/check" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sessionId": "550e8400-e29b-41d4-a716-446655440000",
    "numbers": ["5511999999999", "5511888888888", "5511777777777"]
  }'

{
  "success": true,
  "results": [
    {
      "number": "5511999999999",
      "exists": true,
      "jid": "5511999999999@s.whatsapp.net"
    },
    {
      "number": "5511888888888",
      "exists": true,
      "jid": "5511888888888@s.whatsapp.net"
    },
    {
      "number": "5511777777777",
      "exists": false,
      "jid": null
    }
  ]
}
Verifica uma lista de números de telefone para identificar quais estão registrados no WhatsApp.
Este endpoint possui rate limit específico de 10 requisições/minuto devido a limitações do WhatsApp.

​
Request Body

​
sessionId
string
required
ID da sessão.
​
numbers
string[]
required
Lista de números para verificar (com DDI).Máximo: 50 números por requisiçãoExemplo: ["5511999999999", "5511888888888"]

​
Resposta

​
success
boolean
Se a operação foi bem-sucedida.
​
results
array
Lista de resultados.
curl -X POST "https://api.oxenty.api.br/api/contacts/check" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sessionId": "550e8400-e29b-41d4-a716-446655440000",
    "numbers": ["5511999999999", "5511888888888", "5511777777777"]
  }'

{
  "success": true,
  "results": [
    {
      "number": "5511999999999",
      "exists": true,
      "jid": "5511999999999@s.whatsapp.net"
    },
    {
      "number": "5511888888888",
      "exists": true,
      "jid": "5511888888888@s.whatsapp.net"
    },
    {
      "number": "5511777777777",
      "exists": false,
      "jid": null
    }
  ]
}

​
Boas Práticas

Envie múltiplos números em uma única requisição ao invés de verificar um por um.
Os resultados raramente mudam. Cache por pelo menos 24 horas para evitar verificações repetidas.
10 requisições/minuto é o limite para evitar bloqueios do WhatsApp.