# Histórico Profissional e Renda

> Trajetória profissional completa de uma pessoa física a partir do CPF: empregos formais, sociedades e trabalho informal, com empresa, CNPJ, CNAE, cargo, período, renda mensal estimada e faixa salarial. Consolida RAIS, Receita Federal e bases privadas de redes de vendas, e devolve renda total estimada dos vínculos ativos.

- **Consulta:** `historico-profissional`
- **Categoria:** Trabalhista
- **Preço:** R$ 0,67 por consulta
- **Endpoint:** `GET https://app.fontedata.com/api/v1/consulta/historico-profissional`
- **Autenticação:** header `X-API-Key`
- **Página:** https://fontedata.com/docs/trabalhista/historico-profissional

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> Devolve a trajetória profissional de uma pessoa física a partir do CPF: onde trabalhou, onde trabalha, desde quando, em que cargo e quanto ganha — estimado. Cada vínculo traz a empresa, o CNPJ, o CNAE da atividade, a natureza do empregador, o período e a renda mensal estimada.
>
> Cobre três situações que costumam exigir consultas separadas: **emprego formal** (RAIS), **sociedade** (quadro societário da Receita Federal, para quem é sócio ou empresário) e **trabalho informal** (revenda e autônomos, via bases privadas de redes de vendas) — este último não aparece em RAIS nem em eSocial.
>
> A renda é **estimada** a partir das bases de origem, não é renda declarada nem comprovada. Use como indício e ordem de grandeza, nunca como comprovação documental.

## Requisição

### cURL

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

### Python

```python
import requests

resp = requests.get(
    "https://app.fontedata.com/api/v1/consulta/historico-profissional",
    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/historico-profissional");

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.
>
> **Consolidado**
>
> | Campo | Descrição |
> |-------|-----------|
> | `empregado` | `true` se há ao menos um vínculo ativo. |
> | `total_vinculos` | Quantidade de vínculos encontrados, ativos e encerrados. |
> | `total_vinculos_ativos` | Quantidade de vínculos ativos hoje. |
> | `renda_total_estimada` | Soma, em reais, das rendas estimadas dos vínculos **ativos**. |
> | `faixa_renda_total` | Faixa da renda total em salários mínimos: `ATE 2 SM`, `2 A 4 SM`, `4 A 10 SM`, `10 A 20 SM`, `ACIMA DE 20 SM`. `null` quando a fonte não informa. |
>
> **Cada item de `vinculos`**
>
> | Campo | Descrição |
> |-------|-----------|
> | `empresa` | Razão social do empregador ou da sociedade. |
> | `cnpj` | CNPJ do empregador, sem máscara. `null` em vínculo informal sem CNPJ. |
> | `nivel` | `Empregado`, `Sócio/Empresário`, `Autônomo` ou `Revendedor`. |
> | `ativo` | `true` enquanto o vínculo vigora. |
> | `data_inicio` / `data_fim` | Período do vínculo (`AAAA-MM-DD`). `data_fim` é `null` quando `ativo` é `true`. |
> | `renda` | Renda mensal estimada neste vínculo, em reais. `null` quando a fonte não informa. |
> | `faixa_renda` | Faixa deste vínculo em salários mínimos. `null` quando a fonte não informa. |
> | `natureza` | Natureza do empregador: `Privado`, `Público`, `Informal` ou `Misto`. |
> | `cnae` / `atividade` | Código e descrição da atividade econômica do empregador. |
> | `fonte` | Origem do registro: `RAIS`, `RECEITA FEDERAL` ou base privada de rede de vendas. |
> | `data_criacao` / `data_atualizacao` | Quando o registro entrou e quando foi atualizado na base de origem — leia como a **recência** do vínculo. |
>
> CPF sem nenhum vínculo conhecido devolve `200` com `total_vinculos: 0` e `vinculos: []`. Não é erro: é a resposta "nada encontrado", e é cobrada.

### Exemplo de resposta

```json
{
  "vinculos": [
    {
      "cnae": "5611203",
      "cnpj": "22222222000122",
      "pais": "Brasil",
      "ativo": false,
      "fonte": "RECEITA FEDERAL",
      "nivel": "Sócio/Empresário",
      "renda": null,
      "empresa": "COMERCIO DE ALIMENTOS EXEMPLO LTDA",
      "data_fim": "2020-12-17",
      "natureza": "Privado",
      "atividade": "LANCHONETES, CASAS DE CHA, DE SUCOS E SIMILARES",
      "data_inicio": "2019-10-18",
      "faixa_renda": null,
      "data_criacao": "2019-10-18",
      "data_atualizacao": "2020-12-17"
    },
    {
      "cnae": "6311900",
      "cnpj": "22222222000122",
      "pais": "Brasil",
      "ativo": true,
      "fonte": "RECEITA FEDERAL",
      "nivel": "Sócio/Empresário",
      "renda": 6000,
      "empresa": "TECNOLOGIA EXEMPLO LTDA",
      "data_fim": null,
      "natureza": "Privado",
      "atividade": "TRATAMENTO DE DADOS, PROVEDORES DE SERVICOS DE APLICACAO E SERVICOS DE HOSPEDAGEM NA INTERNET",
      "data_inicio": "2021-03-10",
      "faixa_renda": "4 A 10 SM",
      "data_criacao": "2021-03-10",
      "data_atualizacao": "2026-07-11"
    },
    {
      "cnae": "6424704",
      "cnpj": "22222222000122",
      "pais": "Brasil",
      "ativo": true,
      "fonte": "RAIS",
      "nivel": "Empregado",
      "renda": 3000,
      "empresa": "COOPERATIVA DE CREDITO EXEMPLO",
      "data_fim": null,
      "natureza": "Privado",
      "atividade": "COOPERATIVAS DE CREDITO RURAL",
      "data_inicio": "2017-08-24",
      "faixa_renda": "2 A 4 SM",
      "data_criacao": "2022-02-28",
      "data_atualizacao": "2022-08-20"
    },
    {
      "cnae": null,
      "cnpj": null,
      "pais": "Brasil",
      "ativo": false,
      "fonte": "REDE DE VENDAS",
      "nivel": "Revendedor",
      "renda": null,
      "empresa": "REDE DE VENDAS EXEMPLO",
      "data_fim": "2016-11-30",
      "natureza": "Informal",
      "atividade": null,
      "data_inicio": "2015-03-02",
      "faixa_renda": null,
      "data_criacao": "2015-03-02",
      "data_atualizacao": "2016-11-30"
    }
  ],
  "empregado": true,
  "total_vinculos": 4,
  "faixa_renda_total": "4 A 10 SM",
  "renda_total_estimada": 9000,
  "total_vinculos_ativos": 2
}
```

### Schema da resposta

```json
{
  "type": "object",
  "properties": {
    "vinculos": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "object",
        "properties": {
          "cnae": {
            "type": [
              "string",
              "null"
            ],
            "description": "Código CNAE da atividade econômica do empregador."
          },
          "cnpj": {
            "type": [
              "string",
              "null"
            ],
            "format": "cnpj",
            "description": "CNPJ da empresa do vínculo, sem máscara."
          },
          "pais": {
            "type": [
              "string",
              "null"
            ],
            "description": "País do vínculo."
          },
          "ativo": {
            "type": [
              "boolean",
              "null"
            ],
            "format": "bool",
            "description": "Indica se o vínculo está ativo na data da consulta."
          },
          "fonte": {
            "type": [
              "string",
              "null"
            ],
            "description": "Origem do registro: RAIS, RECEITA FEDERAL ou base privada da rede de vendas."
          },
          "nivel": {
            "type": [
              "string",
              "null"
            ],
            "description": "Natureza do vínculo: Empregado, Sócio/Empresário, Autônomo ou Revendedor."
          },
          "renda": {
            "type": [
              "number",
              "null"
            ],
            "format": "currency",
            "description": "Renda mensal estimada neste vínculo, em reais. Null quando a fonte não informa."
          },
          "empresa": {
            "type": [
              "string",
              "null"
            ],
            "description": "Razão social da empresa do vínculo."
          },
          "data_fim": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "Encerramento do vínculo (AAAA-MM-DD). Null quando o vínculo está ativo."
          },
          "natureza": {
            "type": [
              "string",
              "null"
            ],
            "description": "Natureza do empregador: Privado, Público, Informal ou Misto."
          },
          "atividade": {
            "type": [
              "string",
              "null"
            ],
            "description": "Descrição da atividade econômica do empregador (CNAE)."
          },
          "data_inicio": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "Início do vínculo (AAAA-MM-DD)."
          },
          "faixa_renda": {
            "type": [
              "string",
              "null"
            ],
            "description": "Faixa de renda deste vínculo, em salários mínimos. Null quando a fonte não informa."
          },
          "data_criacao": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "Data em que o registro entrou na base de origem (AAAA-MM-DD)."
          },
          "data_atualizacao": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "Última atualização do registro na base de origem (AAAA-MM-DD)."
          }
        }
      },
      "x-display": "table",
      "description": "Vínculos profissionais da pessoa — empregos formais, sociedades e trabalho informal."
    },
    "empregado": {
      "type": [
        "boolean",
        "null"
      ],
      "format": "bool",
      "description": "Indica se a pessoa possui ao menos um vínculo profissional ativo."
    },
    "total_vinculos": {
      "type": [
        "number",
        "null"
      ],
      "description": "Total de vínculos profissionais encontrados (ativos e encerrados)."
    },
    "faixa_renda_total": {
      "type": [
        "string",
        "null"
      ],
      "description": "Faixa da renda total estimada, em salários mínimos. Valores: ATE 2 SM, 2 A 4 SM, 4 A 10 SM, 10 A 20 SM, ACIMA DE 20 SM. Null quando a fonte não informa."
    },
    "renda_total_estimada": {
      "type": [
        "number",
        "null"
      ],
      "format": "currency",
      "description": "Soma estimada, em reais, das rendas dos vínculos ATIVOS. Estimativa a partir de RAIS e Receita Federal — não é renda declarada."
    },
    "total_vinculos_ativos": {
      "type": [
        "number",
        "null"
      ],
      "description": "Total de vínculos profissionais atualmente ativos."
    }
  }
}
```

## Códigos de erro

| Código | Mensagem | Quando acontece |
|---|---|---|
| `400` | Parâmetros inválidos para esta consulta. | CPF ausente, com dígito verificador inválido ou fora do formato. Máscara é aceita (000.000.000-00). |
| `401` | Chave de API ausente ou inválida. | Header X-API-Key não enviado ou não reconhecido. |
| `403` | Saldo insuficiente ou acesso negado a este endpoint. | Conta sem saldo para cobrir a consulta ou sem permissão no catálogo da marca. |
| `408` | A consulta excedeu o tempo limite. Tente novamente. | A base de origem demorou além do orçamento de tempo da consulta. |
| `451` | Dados indisponíveis por solicitação do titular. | O CPF consultado está sob supressão LGPD. A consulta não é cobrada. |
| `500` | Erro ao processar a consulta. Tente novamente em instantes. | Falha inesperada ao consultar a base de origem. |

## Quando usar

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> - **Análise de crédito** — dimensionar capacidade de pagamento por renda estimada e estabilidade do vínculo (tempo de casa via `data_inicio`), sem depender de holerite.
> - **Validação de renda declarada** — confrontar o que o cliente informou no cadastro com `renda_total_estimada`, e investigar divergências grandes.
> - **KYC e onboarding** — confirmar a ocupação declarada e descobrir sociedades que o cliente não informou (`nivel: Sócio/Empresário` traz o CNPJ para aprofundar).
> - **Prevenção a fraude** — CPF que se declara empregado de uma empresa sem nenhum vínculo com ela na base é sinal de alerta.
> - **Cobrança e recuperação** — localizar empregador atual de devedor para orientar a estratégia.
>
> Para o caminho inverso — a partir de um **CNPJ**, listar os funcionários da empresa com CBO e data de admissão — use o endpoint `vinculo-empregaticio`.

---

Página em HTML: https://fontedata.com/docs/trabalhista/historico-profissional
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