> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oxenty.api.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Verificar Números

> Verifica se números estão registrados no WhatsApp

Verifica uma lista de números de telefone para identificar quais estão registrados no WhatsApp.

<Warning>
  Este endpoint possui rate limit específico de **10 requisições/minuto** devido a limitações do WhatsApp.
</Warning>

## Request Body

<ParamField body="sessionId" type="string" required>
  ID da sessão.
</ParamField>

<ParamField body="numbers" type="string[]" required>
  Lista de números para verificar (com DDI).

  **Máximo:** 50 números por requisição

  **Exemplo:** `["5511999999999", "5511888888888"]`
</ParamField>

## Resposta

<ResponseField name="success" type="boolean">
  Se a operação foi bem-sucedida.
</ResponseField>

<ResponseField name="results" type="array">
  Lista de resultados.

  <Expandable title="Objeto Result">
    <ResponseField name="number" type="string">
      Número verificado.
    </ResponseField>

    <ResponseField name="exists" type="boolean">
      Se está no WhatsApp.
    </ResponseField>

    <ResponseField name="jid" type="string">
      JID do contato (se existir).
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={"system"}
  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"]
    }'
  ```

  ```typescript TypeScript theme={"system"}
  const results = await client.contacts.check(sessionId, {
    numbers: ['5511999999999', '5511888888888', '5511777777777'],
  });

  for (const result of results) {
    if (result.exists) {
      console.log(`${result.number} está no WhatsApp: ${result.jid}`);
    } else {
      console.log(`${result.number} não está no WhatsApp`);
    }
  }
  ```

  ```python Python theme={"system"}
  results = client.contacts.check(
      session_id,
      numbers=['5511999999999', '5511888888888', '5511777777777']
  )

  for result in results['results']:
      if result['exists']:
          print(f"{result['number']} está no WhatsApp: {result['jid']}")
      else:
          print(f"{result['number']} não está no WhatsApp")
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={"system"}
  {
    "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
      }
    ]
  }
  ```
</ResponseExample>

## Boas Práticas

<AccordionGroup>
  <Accordion title="Use verificação em lote" icon="layers">
    Envie múltiplos números em uma única requisição ao invés de verificar um por um.
  </Accordion>

  <Accordion title="Cache os resultados" icon="database">
    Os resultados raramente mudam. Cache por pelo menos 24 horas para evitar verificações repetidas.
  </Accordion>

  <Accordion title="Respeite o rate limit" icon="clock">
    10 requisições/minuto é o limite para evitar bloqueios do WhatsApp.
  </Accordion>
</AccordionGroup>