Validação Cadastral - Brasil

GET https://app.fontedata.com/api/v1/consulta/registration-brazil
R$ 0,43 por consulta

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

Este endpoint realiza consultas de dados cadastrais de pessoas físicas no Brasil. Permite recuperar informações pessoais e socioeconômicas associadas a um CPF, incluindo identificação, contato, endereços e faixa de renda.

Casos de uso:

  • Onboarding e validação de identidade em processos de contas
  • Análise de risco de crédito utilizando dados socioeconômicos
  • Detecção de fraude em cadastramentos e aberturas de conta
  • Conformidade regulatória e verificação de dados cadastrais
  • Análise ESG e compliance com políticas internas

Benefícios:

  • Dados padronizados e atualizados regularmente
  • Redução de atrito no processo de aprovação
  • Conformidade com diretrizes internas e legislação de proteção de dados
  • Informações estruturadas para decisões de negócio mais precisas

Requisição

curl -H "X-API-Key: SUA_CHAVE" \
  "https://app.fontedata.com/api/v1/consulta/registration-brazil?cpf=SEU_CPF&name=SEU_NOME&surname=SEU_SOBRENOME"

Parâmetros

NomeTipoDescriçãoExemplo
cpf obrigatórioCPFCPF (somente números, 11 dígitos)000.000.000-00
dob opcionaltextoData de nascimento do titular (DD/MM/AAAA). Parâmetro opcional que pode ser combinado com name e surname para reforçar a identificação do CPF consultado.
name opcionaltextoNome completo do titular. Parâmetro opcional que pode ser combinado com surname e dob para reforçar a identificação do CPF consultado.Nome completo
surname opcionaltextoSobrenome do titular. Parâmetro opcional que pode ser combinado com name e dob para reforçar a identificação do CPF consultado.Sobrenome

Resposta

A consulta retorna um objeto estruturado contendo:

  • Identificação: Nome, data de nascimento, gênero, idade, CPF, nome da mãe
  • Contato: Lista de telefones (com tipo de linha) e endereços de e-mail
  • Endereço: Rua, número, complemento, bairro, cidade, estado e código postal
  • Dados socioeconômicos: Faixa salarial e renda estimada

Todos os campos relacionados a telefones, endereços e e-mails são retornados como listas, permitindo múltiplos registros para cada tipo de informação.

Exemplo — 200 OK
{
  "age": 38,
  "cpf": "***",
  "name": "***",
  "emails": [
    {
      "emailAddress": "***"
    },
    {
      "emailAddress": "***"
    }
  ],
  "gender": "Feminino",
  "phones": [
    {
      "phoneType": null,
      "phoneNumber": "(11) 991000001"
    },
    {
      "phoneType": null,
      "phoneNumber": "(11) 991000002"
    },
    {
      "phoneType": null,
      "phoneNumber": "(11) 991000003"
    },
    {
      "phoneType": null,
      "phoneNumber": "(11) 32100004"
    },
    {
      "phoneType": null,
      "phoneNumber": "(11) 32100005"
    }
  ],
  "addresses": [
    {
      "city": "JUIZ DE FORA",
      "state": "MG",
      "number": "212",
      "street": "RUA DAS FLORES",
      "complement": null,
      "postalCode": "36010-020",
      "neighborhood": "SAO MATEUS"
    },
    {
      "city": "JUIZ DE FORA",
      "state": "MG",
      "number": "530",
      "street": "AVENIDA RIO BRANCO",
      "complement": "AP 305",
      "postalCode": "36016-310",
      "neighborhood": "CENTRO"
    },
    {
      "city": "NITEROI",
      "state": "RJ",
      "number": "220",
      "street": "RUA VISCONDE DE SEPETIBA",
      "complement": "BL 2 AP 402",
      "postalCode": "24020-207",
      "neighborhood": "ICARAI"
    }
  ],
  "nameMother": "***",
  "dateOfBirth": "***",
  "salaryRange": "1518",
  "estimatedSalary": "Faixa 1 salário mínimo"
}
Schema da resposta (JSON Schema)
JSON Schema
{
  "type": "object",
  "properties": {
    "age": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Idade do indivíduo."
    },
    "cpf": {
      "type": [
        "string",
        "null"
      ],
      "description": "CPF do indivíduo."
    },
    "name": {
      "type": [
        "string",
        "null"
      ],
      "description": "Nome do indivíduo."
    },
    "emails": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "object",
        "properties": {
          "emailAddress": {
            "type": [
              "string",
              "null"
            ],
            "description": "Endereço de e-mail."
          }
        }
      },
      "description": "Lista de endereços de e-mail."
    },
    "gender": {
      "type": [
        "string",
        "null"
      ],
      "description": "Gênero do indivíduo."
    },
    "phones": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "object",
        "properties": {
          "phoneType": {
            "type": [
              "string",
              "null"
            ],
            "description": "Tipo de telefone."
          },
          "phoneNumber": {
            "type": [
              "string",
              "null"
            ],
            "description": "Número de telefone com DDD."
          }
        }
      },
      "x-display": "table",
      "description": "Lista de telefones."
    },
    "addresses": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "object",
        "properties": {
          "city": {
            "type": [
              "string",
              "null"
            ],
            "description": "Cidade."
          },
          "state": {
            "type": [
              "string",
              "null"
            ],
            "description": "Estado."
          },
          "number": {
            "type": [
              "string",
              "null"
            ],
            "description": "Número do endereço."
          },
          "street": {
            "type": [
              "string",
              "null"
            ],
            "description": "Nome da rua, avenida ou logradouro."
          },
          "complement": {
            "type": [
              "string",
              "null"
            ],
            "description": "Complemento do endereço."
          },
          "postalCode": {
            "type": [
              "string",
              "null"
            ],
            "description": "Código postal (CEP)."
          },
          "neighborhood": {
            "type": [
              "string",
              "null"
            ],
            "description": "Bairro."
          }
        }
      },
      "x-display": "table",
      "description": "Lista de endereços."
    },
    "nameMother": {
      "type": [
        "string",
        "null"
      ],
      "description": "Nome da mãe do indivíduo."
    },
    "dateOfBirth": {
      "type": [
        "string",
        "null"
      ],
      "format": "date",
      "description": "Data de nascimento do indivíduo."
    },
    "salaryRange": {
      "type": [
        "string",
        "null"
      ],
      "format": "currency",
      "description": "Renda estimada"
    },
    "estimatedSalary": {
      "type": [
        "string",
        "null"
      ],
      "description": "Faixa salarial"
    }
  }
}

Códigos de erro

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

Observações

  • Cada requisição deve conter apenas um documento/indivíduo
  • Os dados retornados refletem informações disponíveis nos registros consultados
  • A consulta pode não retornar resultados positivos se o CPF não estiver cadastrado ou se os dados pessoais não corresponderem aos registros disponíveis
  • Para melhor aproveitamento, forneça informações precisas nos parâmetros de entrada
  • Em caso de dúvidas sobre interpretação dos dados ou funcionamento da consulta, consulte a documentação técnica adicional

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.