Nível Socioeconômico e Renda

Name: FonteData
Author: FonteData

GET https://app.fontedata.com/api/v1/consulta/nivel-socioeconomico

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 permite consultar o perfil socioeconômico de uma pessoa, consolidando informações sobre sua situação financeira, inserção profissional e grau de instrução. A análise integra dados sobre classe social, ocupação, escolaridade e rendimentos, oferecendo uma visão estratificada das características econômicas do indivíduo.

O serviço atende casos de uso em segmentação de clientes, validação de identidade durante processos de onboarding, avaliação de risco de crédito e conformidade regulatória. É particularmente útil em fluxos de abertura de conta, análise de elegibilidade e prevenção de atividades fraudulentas, permitindo correlacionar dados cadastrais com indicadores socioeconômicos para decisões mais fundamentadas.

Requisição

curl -H "X-API-Key: SUA_CHAVE" \
  "https://app.fontedata.com/api/v1/consulta/nivel-socioeconomico?cpf=SEU_CPF"

Parâmetros

Nome	Tipo	Descrição	Exemplo
cpf obrigatório	CPF	CPF (somente números, 11 dígitos)	000.000.000-00

Resposta

A resposta retorna os seguintes campos:

cpf — CPF consultado
classeSocial — Segmentação do indivíduo em classes socioeconômicas (ex.: A, B, C, D, E)
escolaridade — Nível de instrução formal
cbo — Código da Classificação Brasileira de Ocupações
codigoCBO — Identificador numérico da ocupação
rendaEstimada — Projeção de renda mensal do indivíduo
rendaFaixaSalarial — Faixa de rendimento em múltiplos de salários mínimos
rendaIBGE — Renda estimada conforme padrões de pesquisa econômica nacional
rendaMediaCBO — Rendimento médio para profissionais na mesma ocupação
rendaMinimaCBO — Piso de renda typical para a ocupação
rendaMaximaCBO — Teto de renda typical para a ocupação

Os valores de renda são retornados como strings e podem representar valores monetários ou faixas descritivas, dependendo da disponibilidade de dados.

Exemplo — 200 OK

{
  "cbo": "string",
  "cpf": "string",
  "codigoCBO": "string",
  "rendaIBGE": "string",
  "classeSocial": "string",
  "escolaridade": "string",
  "rendaEstimada": "string",
  "rendaMediaCBO": "string",
  "rendaMaximaCBO": "string",
  "rendaMinimaCBO": "string",
  "perfilDomiciliar": {
    "tipoDomicilio": "string",
    "confiabilidade": "string",
    "rendaPerCapita": "string",
    "rendaDomiciliar": "string",
    "quantidadeAdultos": "number",
    "quantidadeMenores": "number",
    "faixaRendaPerCapita": "string",
    "quantidadeMoradores": "number",
    "classeSocialFamiliar": "string"
  },
  "rendaFaixaSalarial": "string"
}

Schema da resposta (JSON Schema)

JSON Schema

{
  "type": "object",
  "properties": {
    "cbo": {
      "type": [
        "string",
        "null"
      ],
      "description": "Descrição da Classificação Brasileira de Ocupações do indivíduo."
    },
    "cpf": {
      "type": [
        "string",
        "null"
      ],
      "description": "CPF do indivíduo."
    },
    "codigoCBO": {
      "type": [
        "string",
        "null"
      ],
      "description": "Código numérico da Classificação Brasileira de Ocupações."
    },
    "rendaIBGE": {
      "type": [
        "string",
        "null"
      ],
      "description": "Renda do indivíduo segundo dados do IBGE."
    },
    "classeSocial": {
      "type": [
        "string",
        "null"
      ],
      "description": "Classe social do indivíduo."
    },
    "escolaridade": {
      "type": [
        "string",
        "null"
      ],
      "description": "Nível de escolaridade do indivíduo."
    },
    "rendaEstimada": {
      "type": [
        "string",
        "null"
      ],
      "description": "Renda estimada do indivíduo."
    },
    "rendaMediaCBO": {
      "type": [
        "string",
        "null"
      ],
      "description": "Renda média para a ocupação do indivíduo."
    },
    "rendaMaximaCBO": {
      "type": [
        "string",
        "null"
      ],
      "description": "Renda máxima para a ocupação do indivíduo."
    },
    "rendaMinimaCBO": {
      "type": [
        "string",
        "null"
      ],
      "description": "Renda mínima para a ocupação do indivíduo."
    },
    "rendaFaixaSalarial": {
      "type": [
        "string",
        "null"
      ],
      "description": "Faixa salarial do indivíduo baseada em salários mínimos."
    }
  }
}

Observações

A consulta retorna dados estruturados em tempo real, sem geração automática de comprovantes ou registros de auditoria associados
O CPF é o único identificador necessário; aceita qualquer formato, com ou sem pontuação
Os rendimentos baseados em ocupação (CBO) fornecem contexto comparativo para avaliar se a renda declarada está alinhada com a profissão informada
A classe social e escolaridade são derivadas de modelos estatísticos aplicados a dados econômicos agregados
Recomenda-se utilizar este endpoint em conjunto com outras verificações de identidade para validação mais robusta em fluxos críticos de conformidade
Qualquer dúvida sobre a interpretação dos dados ou limitações deve ser encaminhada ao suporte técnico

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.