# Enriquecimento de Lead

> Retorna dados de cadastro de um CPF a partir de e-mail e/ou celular, combinando fontes oficiais com inferências para enriquecimento e qualificação de leads.

- **Consulta:** `enriquecimento-lead`
- **Categoria:** Comercial
- **Preço:** R$ 0,29 por consulta
- **Endpoint:** `GET https://app.fontedata.com/api/v1/consulta/enriquecimento-lead`
- **Autenticação:** header `X-API-Key`
- **Página:** https://fontedata.com/docs/comercial/enriquecimento-lead

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> Retorna dados cadastrais de uma pessoa física — inclusive o **CPF** — a partir do **e-mail e/ou do celular** do contato, combinando fontes oficiais com inferências para enriquecimento e qualificação de leads.
>
> É útil quando você dispõe apenas do contato e precisa recuperar a identificação da pessoa. Diferencia-se do endpoint de consulta de CPF, que exige já conhecer o documento.

## Requisição

### cURL

```bash
curl -H "X-API-Key: SUA_CHAVE" \
  "https://app.fontedata.com/api/v1/consulta/enriquecimento-lead?celular=SEU_TELEFONE"
```

### Python

```python
import requests

resp = requests.get(
    "https://app.fontedata.com/api/v1/consulta/enriquecimento-lead",
    params={"celular": "SEU_TELEFONE"},
    headers={"X-API-Key": "SUA_CHAVE"},
    timeout=60,
)
resp.raise_for_status()
print(resp.json())
```

### Node.js

```javascript
const url = new URL("https://app.fontedata.com/api/v1/consulta/enriquecimento-lead");

url.search = new URLSearchParams({
  "celular": "SEU_TELEFONE"
}).toString();

const resp = await fetch(url, {
  method: "GET",
  headers: { "X-API-Key": "SUA_CHAVE" }
});

if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
console.log(await resp.json());
```

## Parâmetros

Informe `celular` ou `email`.

| Nome | Tipo | Obrigatório | Descrição | Exemplo |
|---|---|---|---|---|
| `email` | texto | condicional | Endereço de e-mail do contato a identificar. Via de entrada alternativa a `celular` — envie ao menos um dos dois, ou ambos para enriquecer o resultado. | formato: nome@dominio.com |
| `celular` | texto | condicional | Telefone celular do contato, aceito com ou sem formatação. Via de entrada alternativa a `email` — envie ao menos um dos dois; se informado, precisa ser um número válido, senão a consulta inteira é rejeitada. | formato: 55DDNNNNNNNNN |

## Resposta

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> | Campo | Descrição |
> |-------|-----------|
> | `cpf` | CPF do indivíduo |
> | `nome` | Nome completo |
> | `dataNascimento` | Data de nascimento (dd/MM/yyyy) |
> | `nomeMae` | Nome da mãe |
> | `sexo`, `idade`, `signo` | Dados demográficos |
> | `emails[]` | E-mails associados |
> | `telefones[]` | Telefones, com operadora, tipo, vínculo com WhatsApp e bloqueio de telemarketing |
> | `enderecos[]` | Endereços com logradouro, número, complemento, bairro, cidade, UF e CEP |
> | `rendaEstimada`, `rendaFaixaSalarial` | Estimativas de renda |
>
> ### Quando o contato não é encontrado
>
> Nem todo contato possui correspondência na base. Quando não há registro para o e-mail ou celular informado, a resposta é **HTTP 200** com o corpo:
>
> ```json
> {
>   "consta": false,
>   "mensagem": "Nenhum dado encontrado para o contato informado.",
>   "parametros": { "email": "fulano@empresa.com.br" }
> }
> ```
>
> Isso **não é um erro**: a consulta foi executada com sucesso e a base não possui dados para aquele contato. Trate sempre o campo `consta` antes de ler os demais campos.

### Exemplo de resposta

```json
{
  "cpf": "***",
  "nome": "***",
  "sexo": "***",
  "idade": 0,
  "signo": null,
  "emails": [],
  "nomeMae": "***",
  "enderecos": [
    {
      "uf": "GO",
      "cep": "***",
      "bairro": "***",
      "cidade": "GOIANIA",
      "numero": null,
      "logradouro": "***",
      "complemento": "***"
    },
    {
      "uf": "RJ",
      "cep": "***",
      "bairro": "***",
      "cidade": "RIO DE JANEIRO",
      "numero": "435",
      "logradouro": "***",
      "complemento": "***"
    }
  ],
  "telefones": [
    {
      "whatsApp": null,
      "operadora": null,
      "tipoTelefone": null,
      "telefoneComDDD": "***",
      "telemarketingBloqueado": null
    },
    {
      "whatsApp": null,
      "operadora": null,
      "tipoTelefone": null,
      "telefoneComDDD": "***",
      "telemarketingBloqueado": null
    },
    {
      "whatsApp": null,
      "operadora": null,
      "tipoTelefone": null,
      "telefoneComDDD": "***",
      "telemarketingBloqueado": null
    },
    {
      "whatsApp": null,
      "operadora": null,
      "tipoTelefone": null,
      "telefoneComDDD": "***",
      "telemarketingBloqueado": null
    },
    {
      "whatsApp": null,
      "operadora": null,
      "tipoTelefone": null,
      "telefoneComDDD": "***",
      "telemarketingBloqueado": null
    }
  ],
  "rendaEstimada": "***",
  "dataNascimento": "***",
  "rendaFaixaSalarial": "Faixa 1 salário mínimo"
}
```

### Schema da resposta

```json
{
  "type": "object",
  "properties": {
    "cpf": {
      "type": [
        "string",
        "null"
      ],
      "description": "CPF do indivíduo."
    },
    "nome": {
      "type": [
        "string",
        "null"
      ],
      "description": "Nome do indivíduo."
    },
    "sexo": {
      "type": [
        "string",
        "null"
      ],
      "description": "Gênero do indivíduo."
    },
    "idade": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Idade do indivíduo."
    },
    "signo": {
      "type": [
        "string",
        "null"
      ],
      "description": "Signo do indivíduo."
    },
    "emails": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "object",
        "properties": {
          "enderecoEmail": {
            "type": [
              "string",
              "null"
            ],
            "description": "Endereço de e-mail."
          }
        }
      },
      "description": "Lista de endereços de e-mail."
    },
    "nomeMae": {
      "type": [
        "string",
        "null"
      ],
      "description": "Nome da mãe do indivíduo."
    },
    "enderecos": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "object",
        "properties": {
          "uf": {
            "type": [
              "string",
              "null"
            ],
            "description": "Unidade Federativa do endereço."
          },
          "cep": {
            "type": [
              "string",
              "null"
            ],
            "description": "CEP do endereço."
          },
          "bairro": {
            "type": [
              "string",
              "null"
            ],
            "description": "Bairro do endereço."
          },
          "cidade": {
            "type": [
              "string",
              "null"
            ],
            "description": "Cidade do endereço."
          },
          "numero": {
            "type": [
              "string",
              "null"
            ],
            "description": "Número do endereço."
          },
          "logradouro": {
            "type": [
              "string",
              "null"
            ],
            "description": "Logradouro do endereço."
          },
          "complemento": {
            "type": [
              "string",
              "null"
            ],
            "description": "Complemento do endereço."
          }
        }
      },
      "description": "Lista de endereços."
    },
    "telefones": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "object",
        "properties": {
          "whatsApp": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Indica se o telefone está vinculado ao WhatsApp."
          },
          "operadora": {
            "type": [
              "string",
              "null"
            ],
            "description": "Operadora do telefone."
          },
          "tipoTelefone": {
            "type": [
              "string",
              "null"
            ],
            "description": "Tipo do telefone."
          },
          "telefoneComDDD": {
            "type": [
              "string",
              "null"
            ],
            "description": "Número de telefone com DDD."
          },
          "telemarketingBloqueado": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Indica se o telefone está bloqueado para telemarketing."
          }
        }
      },
      "description": "Lista de telefones."
    },
    "rendaEstimada": {
      "type": [
        "string",
        "null"
      ],
      "description": "Renda estimada do indivíduo."
    },
    "dataNascimento": {
      "type": [
        "string",
        "null"
      ],
      "description": "Data de nascimento do indivíduo."
    },
    "rendaFaixaSalarial": {
      "type": [
        "string",
        "null"
      ],
      "description": "Faixa salarial estimada."
    }
  }
}
```

## Códigos de erro

| Código | Mensagem | Quando acontece |
|---|---|---|
| `400` | Requisição Inválida | a requisição está incorreta ou os parâmetros são inválidos. |
| `401` | Não Autenticado | o usuário não forneceu as credenciais corretas para acessar o recurso. |
| `403` | Não Autorizado | o servidor recebeu a requisição, mas se negou a autorizá-la por conta de saldo indisponível. |
| `404` | Não Encontrado | o servidor não encontrou uma representação atual do recurso solicitado. |
| `408` | Tempo Esgotado | o servidor não conseguiu retornar a requisição no prazo estabelecido. |
| `500` | Falha ao Realizar Consulta | o servidor não conseguiu processar a requisição com sucesso. Por favor, entre em contato com o nosso suporte. |
| `503` | Consulta em Manutenção | a consulta requisitada está em manutenção. Por favor, entre em contato com o nosso suporte. |

## Quando usar

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> - Descoberta do CPF a partir de um contato (e-mail ou celular)
> - Preenchimento automático de formulários de cadastro com dados validados
> - Qualificação e score de leads, segmentação de audiência e personalização de campanhas
> - Roteamento de leads para equipes de vendas com base em perfil
> - Validação de identidade e detecção de inconsistências em onboarding
> - Análise de risco de crédito, prevenção a fraudes e verificações de compliance
>
> Recomenda-se validar dados críticos (nome, data de nascimento) antes de usar em fluxos automáticos sensíveis. A consulta não gera comprovantes ou certidões.

---

Página em HTML: https://fontedata.com/docs/comercial/enriquecimento-lead
Catálogo completo: https://fontedata.com/docs
OpenAPI (JSON): https://app.fontedata.com/api/v1/openapi.json
Conectar via MCP: https://fontedata.com/docs/mcp