# Nível Socioeconômico e Renda

> Consulta dados socioeconômicos de um indivíduo (renda, ocupação, escolaridade) a partir do CPF. Utilizado para segmentação de perfil em análises de risco, onboarding e compliance.

- **Consulta:** `nivel-socioeconomico`
- **Categoria:** Pessoa Física
- **Preço:** R$ 0,43 por consulta
- **Endpoint:** `GET https://app.fontedata.com/api/v1/consulta/nivel-socioeconomico`
- **Autenticação:** header `X-API-Key`
- **Página:** https://fontedata.com/docs/pessoa-fisica/nivel-socioeconomico

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> 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

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

### Python

```python
import requests

resp = requests.get(
    "https://app.fontedata.com/api/v1/consulta/nivel-socioeconomico",
    params={"cpf": "SEU_CPF"},
    headers={"X-API-Key": "SUA_CHAVE"},
    timeout=60,
)
resp.raise_for_status()
print(resp.json())
```

### Node.js

```javascript
const url = new URL("https://app.fontedata.com/api/v1/consulta/nivel-socioeconomico");

url.search = new URLSearchParams({
  "cpf": "SEU_CPF"
}).toString();

const resp = await fetch(url, {
  method: "GET",
  headers: { "X-API-Key": "SUA_CHAVE" }
});

if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
console.log(await resp.json());
```

## Parâmetros

| Nome | Tipo | Obrigatório | Descrição | Exemplo |
|---|---|---|---|---|
| `cpf` | CPF | sim | CPF (somente números, 11 dígitos) | formato: 000.000.000-00 |

## Resposta

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> 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 de resposta

```json
{
  "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
{
  "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

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> - 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

---

Página em HTML: https://fontedata.com/docs/pessoa-fisica/nivel-socioeconomico
Catálogo completo: https://fontedata.com/docs
OpenAPI (JSON): https://app.fontedata.com/api/v1/openapi.json
Conectar via MCP: https://fontedata.com/docs/mcp