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
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âmetro | Descrição | Regra |
|---|---|---|
cpf | CPFCPF do pesquisado, somente dígitos ou formatado. | Obrigatório |
O que você recebe
25 campos no retorno, como o seu sistema recebe.
cpfDado pessoalCPF
Número do CPF da pessoa física.
nomeDado pessoalNome
Nome completo da pessoa física.
sexoDado pessoalGênero
Gênero ou sexo da pessoa, como a fonte registra.
dataNascimentoDado pessoalData de nascimento
Data de nascimento da pessoa física.
nomeMaeDado pessoalNome da mãe
Nome completo da mãe da pessoa.
idadeDado pessoalIdade
Idade da pessoa, em anos.
signoDado pessoalSigno
Signo do zodíaco, calculado pela data de nascimento.
telefonesDado pessoalTelefones
Telefones ligados ao documento, com DDD. Tipo, operadora, WhatsApp e bloqueio vêm quando a base os tem.
telefones[].telefoneComDDDDado pessoalTelefone
Telefone de contato registrado na fonte. Com DDD.
telefones[].tipoTelefoneTipo de telefone
Se o número é fixo ou móvel, como a base registra.
telefones[].operadoraOperadora
Operadora de telefonia do número, como a base registra.
telefones[].whatsAppTem WhatsApp
Verdadeiro quando o número tem WhatsApp, segundo a base.
telefones[].telemarketingBloqueadoBloqueado para telemarketing
Verdadeiro quando o número consta em cadastro de bloqueio de telemarketing, como o do Procon.
enderecosDado pessoalEndereços
Endereços ligados ao documento, com logradouro, número, complemento, bairro, cidade, UF e CEP.
enderecos[].logradouroDado pessoalLogradouro
Rua, avenida ou estrada do endereço.
enderecos[].numeroDado pessoalNúmero
Número do endereço.
enderecos[].complementoDado pessoalComplemento
Complemento do endereço.
enderecos[].bairroBairro
Bairro ou distrito.
enderecos[].cidadeMunicípio
Nome do município.
enderecos[].ufUF
Sigla do estado.
enderecos[].cepDado pessoalCEP
Código de Endereçamento Postal.
emailsDado pessoalE-mails
E-mails ligados ao documento.
emails[].enderecoEmailDado pessoalE-mail
Endereço eletrônico registrado na fonte.
rendaEstimadaDado pessoalRenda estimada
Renda mensal estimada da pessoa. Valor mensal em reais, como texto com ponto decimal (ex.: 4850.00).
rendaFaixaSalarialDado pessoalFaixa 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"{ "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 */ }}Perguntas frequentes sobre Cadastro - Pessoa Física - Básica
Outras APIs para combinar
Ver catálogo completoReceita Federal - Pessoa Física
Situação do CPF na Receita Federal: regularidade, inscrição e indicador de óbito.
Receita Federal - Pessoa Jurídica
Ficha cadastral do CNPJ na Receita Federal: situação, CNAE, capital social e, opcionalmente, o quadro societário.
Suframa
Situação cadastral da empresa na Suframa: habilitação e regularidade na Zona Franca de Manaus.
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.