Para que serve
Estima a renda mensal da pessoa pelo CPF, com faixa salarial, e compara com a renda de referência da ocupação (CBO) e do IBGE. Traz também classe social, escolaridade e o perfil do domicílio: tipo, moradores, renda domiciliar e per capita e a confiabilidade da estimativa.
Ideal para
Por que usar
Renda sem pedir comprovante
Uma estimativa para calibrar limite e oferta antes de pedir documentos.
Contexto do domicílio
Renda familiar e per capita mostram a capacidade real de pagamento.
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
15 campos no retorno, como o seu sistema recebe.
cpfDado pessoalCPF
Número do CPF da pessoa física.
rendaEstimadaDado pessoalRenda estimada
Renda mensal estimada da pessoa.
rendaFaixaSalarialDado pessoalFaixa de renda
Faixa da renda mensal estimada da pessoa.
rendaMinimaCBORenda da ocupação
Renda de referência da ocupação (CBO) da pessoa: mínima, média ou máxima, conforme o campo. Mínima da ocupação.
rendaMediaCBORenda da ocupação
Renda de referência da ocupação (CBO) da pessoa: mínima, média ou máxima, conforme o campo. Média da ocupação.
rendaMaximaCBORenda da ocupação
Renda de referência da ocupação (CBO) da pessoa: mínima, média ou máxima, conforme o campo. Máxima da ocupação.
rendaIBGERenda de referência do IBGE
Renda média de referência do IBGE para o perfil da pessoa.
codigoCBODado pessoalOcupação (CBO)
Ocupação na Classificação Brasileira de Ocupações: código ou descrição, conforme o campo. Código.
cboDado pessoalOcupação (CBO)
Ocupação na Classificação Brasileira de Ocupações: código ou descrição, conforme o campo. Descrição.
classeSocialDado pessoalClasse social
Classe social estimada (A a E).
escolaridadeDado pessoalEscolaridade
Grau de instrução da pessoa.
perfilDomiciliarDado pessoalPerfil do domicílio
Tipo de domicílio, moradores (adultos e menores), renda domiciliar e per capita, faixa e classe social da família e a confiabilidade da estimativa.
perfilDomiciliar.rendaDomiciliarDado pessoalRenda domiciliar
Renda mensal estimada do domicílio.
perfilDomiciliar.classeSocialFamiliarDado pessoalClasse social
Classe social estimada (A a E). Da família.
perfilDomiciliar.confiabilidadeConfiabilidade da estimativa
Grau de confiança da estimativa de renda e perfil.
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/nivel-socioeconomico-renda-estimada?cpf=00000000000" \ -H "X-Api-Key: $AGROLITICS_API_KEY"{ "metaDados": { "consultaId": "3f9c2a71-5b8e-4d1a-9c07-1e6b2f8a4d90", "apiIdentificador": "nivel-socioeconomico-renda-estimada", "apiNome": "Nível Socioeconômico e Renda Estimada", "fonte": "Renda estimada · CBO e IBGE", "status": "Concluída", "resultado": "Sucesso", "tempoExecucaoMs": 1840, "assincrono": false, "urlComprovante": null }, "retorno": { /* dados da fonte — variam por consulta */ }}Perguntas frequentes sobre Nível Socioeconômico e Renda Estimada
Outras APIs para combinar
Ver catálogo completoSCR — Analítico
Resumo analítico do endividamento no SCR do Banco Central: modalidades, valores e situação das operações de crédito, por CPF ou CNPJ.
SCR — Detalhada
Posição detalhada do SCR do Banco Central por modalidade e vencimento, com opção de mês de competência (MM/aaaa).
Protestos Nacional
Protestos de títulos em cartórios de todo o país, em tempo real, por CPF ou CNPJ.
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.