Enriquecimento de Lead

Name: FonteData
Author: FonteData

GET https://app.fontedata.com/api/v1/consulta/enriquecimento-lead

R$ 0,29 por consulta

Debitado do seu saldo a cada chamada cobrada. Autenticação pelo header X-API-Key. Veja como obter a chave.

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 -H "X-API-Key: SUA_CHAVE" \
  "https://app.fontedata.com/api/v1/consulta/enriquecimento-lead?celular=SEU_TELEFONE"

Parâmetros

Informe celular ou email.

Nome	Tipo	Descrição	Exemplo
email condicional	texto	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.	nome@dominio.com
celular condicional	texto	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.	55DDNNNNNNNNN

Resposta

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:

{
  "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 — 200 OK

{
  "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 Schema)

JSON Schema

{
  "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

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.

Integrar

OpenAPI (JSON) ↗ — importe a URL no Postman ou no Insomnia para gerar a coleção com todos os endpoints. Também dá para consultar pelo chat: conecte via MCP. Esta página em Markdown.