> 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/buscar-dados-privados.md).

# Buscar dados privados

## 🪙 Buscar dados privados (consome créditos)

> Aciona enriquecimento via serviços \*\*pagos\*\* (Unitfour Intouch, etc.) para\
> encontrar \*\*telefones e e-mails privados\*\* do contato — dados que \*\*não estão\
> publicamente disponíveis\*\* na Receita Federal.\
> \
> \### ⚠️ Atenção\
> \- \*\*Consome créditos da sua conta\*\* — confirme saldo no painel antes.\
> \- Custo: \~1 crédito por telefone, \~1 crédito por e-mail.\
> \- Resultado \*\*persistido\*\* — não cobramos 2x pelo mesmo dado.\
> \- Falha de saldo retorna \`402 Payment Required\` — não consome.\
> \
> \### Quando usar\
> \- Lead "quente" (já abriu e-mail, baixou material).\
> \- Próximo passo do funil — antes de discar.\
> \- \*\*Não use em massa sem qualificação\*\* — gasta créditos sem ROI.<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":{"Phone":{"type":"object","properties":{"id":{"type":"integer","description":"ID interno do telefone (`est_codigo`)."},"number":{"type":"string","description":"Número sem máscara, com DDD."},"type":{"type":"string","enum":["CELULAR","FIXO"]},"whatsapp":{"type":"boolean","description":"Se o número está conectado ao WhatsApp (resultado da última verificação)."},"valid":{"type":"boolean","description":"Se foi validado por algum probe (DNS/portabilidade)."},"priority":{"type":"integer","description":"Ordem de exibição (1 = principal)."},"source":{"type":"string","description":"Origem do dado (`receita`, `manual`, `intouch`, etc.)."}}},"Email":{"type":"object","properties":{"id":{"type":"integer"},"email":{"type":"string","format":"email"},"valid":{"type":"boolean"},"priority":{"type":"integer"},"source":{"type":"string"}}},"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/find-private-data":{"post":{"tags":["Contact"],"summary":"🪙 Buscar dados privados (consome créditos)","operationId":"contactFindPrivateData","description":"Aciona enriquecimento via serviços **pagos** (Unitfour Intouch, etc.) para\nencontrar **telefones e e-mails privados** do contato — dados que **não estão\npublicamente disponíveis** na Receita Federal.\n\n### ⚠️ Atenção\n- **Consome créditos da sua conta** — confirme saldo no painel antes.\n- Custo: ~1 crédito por telefone, ~1 crédito por e-mail.\n- Resultado **persistido** — não cobramos 2x pelo mesmo dado.\n- Falha de saldo retorna `402 Payment Required` — não consome.\n\n### Quando usar\n- Lead \"quente\" (já abriu e-mail, baixou material).\n- Próximo passo do funil — antes de discar.\n- **Não use em massa sem qualificação** — gasta créditos sem ROI.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["id"],"properties":{"id":{"type":"integer"}}}}}},"responses":{"200":{"description":"Dados encontrados (créditos consumidos).","content":{"application/json":{"schema":{"type":"object","properties":{"response":{"type":"string","enum":["success"]},"message":{"type":"string"},"phones_found":{"type":"integer","description":"Quantos novos telefones foram encontrados."},"emails_found":{"type":"integer"},"phones":{"type":"array","items":{"$ref":"#/components/schemas/Phone"}},"emails":{"type":"array","items":{"$ref":"#/components/schemas/Email"}}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"description":"Sem créditos suficientes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"$ref":"#/components/responses/NotFound"}}}}}}
```