NovoCentral de APIs
Crédito

Nível Socioeconômico e Renda Estimada

Renda estimada do CPF (valor e faixa salarial) comparada à renda da ocupação (CBO) e do IBGE, com classe social, escolaridade e perfil do domicílio.

Fonte
Renda estimada · CBO e IBGE
Entrada
CPF
Comprovante PDF
Não emite
Preço
R$ 0,36 por chamada
GEThttps://api.agrolitics.com.br/api/Marketplace/Consulta/nivel-socioeconomico-renda-estimada?cpf=00000000000

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

Definição de limite e ticketSegmentação de clientesPrevenção a fraude de rendaCobrança

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âmetroDescriçãoRegra
cpfCPFCPF do pesquisado, somente dígitos ou formatado.Obrigatório

O que você recebe

15 campos no retorno, como o seu sistema recebe.

  • cpfDado pessoal

    CPF

    Número do CPF da pessoa física.

  • rendaEstimadaDado pessoal

    Renda estimada

    Renda mensal estimada da pessoa.

  • rendaFaixaSalarialDado pessoal

    Faixa de renda

    Faixa da renda mensal estimada da pessoa.

  • rendaMinimaCBO

    Renda 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.

  • rendaMediaCBO

    Renda 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.

  • rendaMaximaCBO

    Renda 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.

  • rendaIBGE

    Renda de referência do IBGE

    Renda média de referência do IBGE para o perfil da pessoa.

  • codigoCBODado pessoal

    Ocupação (CBO)

    Ocupação na Classificação Brasileira de Ocupações: código ou descrição, conforme o campo. Código.

  • cboDado pessoal

    Ocupação (CBO)

    Ocupação na Classificação Brasileira de Ocupações: código ou descrição, conforme o campo. Descrição.

  • classeSocialDado pessoal

    Classe social

    Classe social estimada (A a E).

  • escolaridadeDado pessoal

    Escolaridade

    Grau de instrução da pessoa.

  • perfilDomiciliarDado pessoal

    Perfil 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 pessoal

    Renda domiciliar

    Renda mensal estimada do domicílio.

  • perfilDomiciliar.classeSocialFamiliarDado pessoal

    Classe social

    Classe social estimada (A a E). Da família.

  • perfilDomiciliar.confiabilidade

    Confiabilidade 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"
Resposta · envelope padrão
200 OK
{  "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 */ }}
Referência completa no Swagger

Perguntas frequentes sobre Nível Socioeconômico e Renda Estimada

Não. É uma estimativa estatística a partir de bases de referência, e a confiabilidade vem no retorno. Use como indicativo, não como comprovação.

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.