NovoCentral de APIs
Cadastral

Cadastro - Pessoa Física - Básica

Dados cadastrais e de contato do CPF: nome, sexo, nascimento, idade, nome da mãe, telefones (com operadora e WhatsApp), endereços, e-mails e renda estimada.

Fonte
Dados cadastrais · bases públicas e privadas
Entrada
CPF
Comprovante PDF
Não emite
Preço
R$ 0,16 por chamada
GEThttps://api.agrolitics.com.br/api/Marketplace/Consulta/cadastro-pessoa-fisica-basica?cpf=00000000000

Para que serve

Traz os dados cadastrais e de contato da pessoa pelo CPF: nome, sexo, data de nascimento, idade, signo e nome da mãe; telefones, com tipo, operadora e indicação de WhatsApp e de bloqueio de telemarketing; endereços e e-mails; e a renda mensal estimada, com a faixa em salários mínimos. É o enriquecimento básico para cadastrar, localizar e contatar a pessoa.

Ideal para

Atualização de cadastroLocalização e contatoCobrança e recuperação de créditoOnboarding e KYCEnriquecimento de carteira

Por que usar

  • Contato pronto para usar

    Telefones com operadora e indicação de WhatsApp, e o aviso de bloqueio de telemarketing antes da ligação.

  • Cadastro numa chamada

    Nome, nascimento, filiação, endereços e e-mails no mesmo retorno.

  • Pronto para o seu sistema

    Resposta em JSON estruturado, com os mesmos campos em toda consulta, para entrar direto no seu motor de regras.

Parâmetros

ParâmetroDescriçãoRegra
cpfCPFCPF do pesquisado, somente dígitos ou formatado.Obrigatório

O que você recebe

25 campos no retorno, como o seu sistema recebe.

  • cpfDado pessoal

    CPF

    Número do CPF da pessoa física.

  • nomeDado pessoal

    Nome

    Nome completo da pessoa física.

  • sexoDado pessoal

    Gênero

    Gênero ou sexo da pessoa, como a fonte registra.

  • dataNascimentoDado pessoal

    Data de nascimento

    Data de nascimento da pessoa física.

  • nomeMaeDado pessoal

    Nome da mãe

    Nome completo da mãe da pessoa.

  • idadeDado pessoal

    Idade

    Idade da pessoa, em anos.

  • signoDado pessoal

    Signo

    Signo do zodíaco, calculado pela data de nascimento.

  • telefonesDado pessoal

    Telefones

    Telefones ligados ao documento, com DDD. Tipo, operadora, WhatsApp e bloqueio vêm quando a base os tem.

  • telefones[].telefoneComDDDDado pessoal

    Telefone

    Telefone de contato registrado na fonte. Com DDD.

  • telefones[].tipoTelefone

    Tipo de telefone

    Se o número é fixo ou móvel, como a base registra.

  • telefones[].operadora

    Operadora

    Operadora de telefonia do número, como a base registra.

  • telefones[].whatsApp

    Tem WhatsApp

    Verdadeiro quando o número tem WhatsApp, segundo a base.

  • telefones[].telemarketingBloqueado

    Bloqueado para telemarketing

    Verdadeiro quando o número consta em cadastro de bloqueio de telemarketing, como o do Procon.

  • enderecosDado pessoal

    Endereços

    Endereços ligados ao documento, com logradouro, número, complemento, bairro, cidade, UF e CEP.

  • enderecos[].logradouroDado pessoal

    Logradouro

    Rua, avenida ou estrada do endereço.

  • enderecos[].numeroDado pessoal

    Número

    Número do endereço.

  • enderecos[].complementoDado pessoal

    Complemento

    Complemento do endereço.

  • enderecos[].bairro

    Bairro

    Bairro ou distrito.

  • enderecos[].cidade

    Município

    Nome do município.

  • enderecos[].uf

    UF

    Sigla do estado.

  • enderecos[].cepDado pessoal

    CEP

    Código de Endereçamento Postal.

  • emailsDado pessoal

    E-mails

    E-mails ligados ao documento.

  • emails[].enderecoEmailDado pessoal

    E-mail

    Endereço eletrônico registrado na fonte.

  • rendaEstimadaDado pessoal

    Renda estimada

    Renda mensal estimada da pessoa. Valor mensal em reais, como texto com ponto decimal (ex.: 4850.00).

  • rendaFaixaSalarialDado pessoal

    Faixa de renda

    Faixa da renda mensal estimada da pessoa. Em salários mínimos (ex.: Faixa 3 salários mínimos).

Opções da chamada

  • assincrono=trueProcessa em segundo plano e devolve 202 com o consultaId.
  • comprovante=trueEsta API não emite comprovante em PDF.

Códigos de resposta

  • 200Sucesso — Consulta concluída; o retorno traz os dados da fonte.
  • 202Em processamento — Recupere em GET /api/Marketplace/Consulta/Resultado/{consultaId}. Recuperar não é cobrado.
  • 422Requisição inválida — Parâmetros validados antes de qualquer cobrança.
  • 429Limite simultâneo — Até 5 consultas simultâneas por cliente.
  • 503Em manutenção — A consulta está temporariamente indisponível; nada é cobrado.

Como é cobrado

  • Débito por chamada — do saldo pré-pago ou do contrato pós-pago
  • Preço exibido na plataforma antes de executar
  • Falhas estornadas automaticamente
  • Mesmo preço na plataforma e na API
curl "https://api.agrolitics.com.br/api/Marketplace/Consulta/cadastro-pessoa-fisica-basica?cpf=00000000000" \  -H "X-Api-Key: $AGROLITICS_API_KEY"
Resposta · envelope padrão
200 OK
{  "metaDados": {    "consultaId": "3f9c2a71-5b8e-4d1a-9c07-1e6b2f8a4d90",    "apiIdentificador": "cadastro-pessoa-fisica-basica",    "apiNome": "Cadastro - Pessoa Física - Básica",    "fonte": "Dados cadastrais · bases públicas e privadas",    "status": "Concluída",    "resultado": "Sucesso",    "tempoExecucaoMs": 1840,    "assincrono": false,    "urlComprovante": null  },  "retorno": { /* dados da fonte — variam por consulta */ }}
Referência completa no Swagger

Perguntas frequentes sobre Cadastro - Pessoa Física - Básica

A Plus traz tudo desta consulta e mais: indicador de óbito, nome do pai, ocupação (CBO), classe social, situação cadastral do CPF, parentes e o perfil do domicílio.

Comece a integrar

Leve as fontes oficiais do agro para dentro do seu sistema

Crie sua conta e teste qualquer API na plataforma — ou fale com um especialista para desenhar a integração e o contrato ideais para o seu volume.

  • APIs de fontes oficiais, com resposta padronizada
  • Pague por chamada — sem mensalidade, falhas estornadas
  • API do Dossiê BNIR com lotes de até 1.000 CARs
  • Webhooks assinados e comprovante em PDF
  • Conformidade LGPD — fontes oficiais, log auditável

Solicite uma Demonstração

Nossa equipe entrará em contato em breve.

Sem compromisso. Seus dados são usados só para este contato, conforme a Política de Privacidade.