> For the complete documentation index, see [llms.txt](https://outboundpro.gitbook.io/api-v1/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://outboundpro.gitbook.io/api-v1/contact/verificar-e-mails.md).

# Verificar e-mails

## Verificar e-mails do contato (DNS + SMTP)

> Roda verificação ativa em todos os e-mails cadastrados do contato:\
> \
> 1\. \*\*DNS lookup\*\* (MX record do domínio).\
> 2\. \*\*SMTP probe\*\* (handshake sem entregar e-mail).\
> 3\. \*\*Heurísticas\*\* (catch-all, role-based, disposable, etc.).\
> \
> Retorna \`status\` por e-mail:\
> \- \`1\` = pending (em fila)\
> \- \`2\` = valid\
> \- \`3\` = invalid\
> \- \`4\` = catch-all (pode existir, não dá pra saber)\
> \
> \### Limites\
> \- Custo computacional: \~3–8 s por probe (network bound).\
> \- Não rode em loop — bufferize verificações.\
> \- Resultados são \*\*persistidos\*\* no banco — chamar 2x sem nova evidência\
> &#x20; retorna o mesmo resultado da última.<br>

```json
{"openapi":"3.0.3","info":{"title":"OutboundPro API","version":"2.0.0"},"tags":[{"name":"Contact","description":"**Sócios e contatos de empresas** (`emp_socio` no banco interno).\nOperações completas: listar, criar, editar, marcar como principal,\ninferir e verificar e-mails, verificar WhatsApp, buscar dados privados\n(com créditos), e listar outras empresas onde o contato é sócio.\n\n### Conceitos chave\n- **Contato principal** (`is_primary_contact`): cada empresa tem 1 contato\n  marcado como principal. `set-primary` automaticamente despromove o anterior.\n- **Prospectado** (`is_prospected`): flag de \"este contato vai entrar no\n  funil de prospecção\". Marcar/desmarcar via `toggle-save`.\n- **Inferência de e-mail**: gera candidato a e-mail baseado em nome do contato\n  + domínio do website da empresa (ex.: `joao.silva@empresa.com.br`),\n  com score de confiança. **Não envia teste** — apenas predição.\n- **Verificação de e-mail**: probe DNS + SMTP nos e-mails cadastrados, retorna\n  `status` (1=pending, 2=valid, 3=invalid).\n- **Verificação de WhatsApp**: testa cada número, retorna `whatsapp: true/false`\n  + `whatsapp_name` e `whatsapp_photo` se disponível.\n- **Dados privados** (`find-private-data`): **consome créditos pagos**, busca\n  telefones/emails em serviços externos (Unitfour Intouch, etc.). Verifique\n  saldo antes.\n\n### Performance\nEndpoint `contact/list` sem filtro varre toda a tabela `empresa_socio` —\nuse `lead_id` ou `lead_hash` para escopo restrito (recomendado).\n"}],"servers":[{"url":"https://app.outboundpro.com.br/api","description":"Produção"}],"security":[{"TokenAuth":[]}],"components":{"securitySchemes":{"TokenAuth":{"type":"apiKey","in":"header","name":"Token","description":"Chave privada do cliente (`cli_chave_privada`). Formato UUID v4\n(36 caracteres com hífens). Aceita header em qualquer case\n(`Token`, `token`, `TOKEN`).\n"}},"schemas":{"ErrorResponse":{"type":"object","required":["response"],"properties":{"response":{"type":"string","enum":["error"]},"mensagem":{"type":"string","description":"Descrição do erro em pt-BR. Família Contact usa `message` (legado)."},"message":{"type":"string","description":"Equivalente inglês de `mensagem`, usado pela família Contact."}}}},"responses":{"Unauthorized":{"description":"Token ausente, inválido ou cliente inativo.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"NotFound":{"description":"Recurso não encontrado. Pode ser por:\n- ID inexistente.\n- ID existe **em outro cliente** (isolamento de tenant retorna 404, não 403).\n- Recurso foi deletado/soft-deleted.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"paths":{"/contact/verify-emails":{"post":{"tags":["Contact"],"summary":"Verificar e-mails do contato (DNS + SMTP)","operationId":"contactVerifyEmails","description":"Roda verificação ativa em todos os e-mails cadastrados do contato:\n\n1. **DNS lookup** (MX record do domínio).\n2. **SMTP probe** (handshake sem entregar e-mail).\n3. **Heurísticas** (catch-all, role-based, disposable, etc.).\n\nRetorna `status` por e-mail:\n- `1` = pending (em fila)\n- `2` = valid\n- `3` = invalid\n- `4` = catch-all (pode existir, não dá pra saber)\n\n### Limites\n- Custo computacional: ~3–8 s por probe (network bound).\n- Não rode em loop — bufferize verificações.\n- Resultados são **persistidos** no banco — chamar 2x sem nova evidência\n  retorna o mesmo resultado da última.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["id"],"properties":{"id":{"type":"integer"}}}}}},"responses":{"200":{"description":"Verificação concluída.","content":{"application/json":{"schema":{"type":"object","properties":{"response":{"type":"string","enum":["success"]},"message":{"type":"string"},"results":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"email":{"type":"string","format":"email"},"status":{"type":"integer"},"valid":{"type":"boolean"},"message":{"type":"string","description":"Detalhe textual do resultado."}}}}}}}}},"400":{"description":"Contato sem e-mails cadastrados.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"}}}}}}
```