# Consulta básica CPF

> Consulta que consolida os dados cadastrais básicos de uma pessoa física - nome completo, CPF, data de nascimento e filiação - cruzando fontes oficiais com dados complementares e inferências para compor um perfil cadastral confiável.

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

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> Consulta os dados cadastrais essenciais de uma pessoa física a partir do CPF informado. Este endpoint permite obter informações de identificação como nome completo, filiação, data de nascimento, sexo e nacionalidade, além de atributos complementares como idade calculada, situação cadastral e indicativo de óbito.
>
> O serviço é útil para validação de identidade, preenchimento automático de cadastros, verificação em processos de onboarding, conferência de dados em análises de crédito e enriquecimento de bases internas. A consulta retorna informações estruturadas sobre o titular do CPF, incluindo dados de inscrição e status atual do registro.

## Requisição

### cURL

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

### Python

```python
import requests

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

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 contém os seguintes campos principais:
>
> **Identificação do titular:**
> - `cpf`: CPF consultado, somente dígitos
> - `nome`: Nome completo conforme registro oficial
> - `sexo`: Sexo informado no cadastro (`M` ou `F`)
> - `nacionalidade`: Nacionalidade declarada (ex.: `BRASILEIRA`)
>
> **Dados de nascimento e idade:**
> - `data_nascimento`: Data de nascimento em formato ISO 8601 (UTC)
> - `idade`: Idade atual calculada a partir da data de nascimento
>
> **Filiação:**
> - `nome_mae`: Nome da mãe do titular
> - `nome_pai`: Nome do pai do titular (pode retornar string vazia quando não disponível)
>
> **Situação e registro do CPF:**
> - `situacao_cadastral`: Status atual do CPF (`REGULAR`, `SUSPENSA`, `PENDENTE DE REGULARIZAÇÃO`, `CANCELADA` ou `NULA`)
> - `obito`: Indicador booleano de registro de óbito associado ao CPF
> - `uf_inscricao`: UF ou conjunto de UFs da inscrição original (pode conter múltiplas siglas separadas por hífen, ex.: `DF-GO-MS-MT-TO`)
> - `data_inscricao_cpf`: Data de emissão do CPF em formato ISO 8601 (UTC)
>
> **Recência do dado:**
> - `atualizado_em`: Data da última atualização deste registro na base consultada, no formato ISO 8601 de data (`AAAA-MM-DD`). Indica de quando é a informação entregue.

### Exemplo de resposta

```json
{
  "cpf": "string",
  "nome": "string",
  "sexo": "string",
  "idade": "number",
  "obito": "boolean",
  "nome_mae": "string",
  "nome_pai": "string",
  "uf_inscricao": "string",
  "atualizado_em": "string",
  "nacionalidade": "string",
  "data_nascimento": "string",
  "data_inscricao_cpf": "string",
  "data_nascimento_br": "string",
  "situacao_cadastral": "string"
}
```

### Schema da resposta

```json
{
  "type": "object",
  "properties": {
    "cpf": {
      "type": [
        "string",
        "null"
      ],
      "description": "CPF"
    },
    "nome": {
      "type": [
        "string",
        "null"
      ],
      "description": "Nome Completo da Pessoa"
    },
    "sexo": {
      "type": [
        "string",
        "null"
      ],
      "description": "Sexo da Pessoa Abreviado"
    },
    "idade": {
      "type": [
        "number",
        "null"
      ],
      "description": "Idade da pessoa em anos"
    },
    "obito": {
      "type": [
        "boolean",
        "null"
      ],
      "format": "bool",
      "description": "Existe registro de Óbito?"
    },
    "nome_mae": {
      "type": [
        "string",
        "null"
      ],
      "description": "Nome da Mãe da Pessoa"
    },
    "nome_pai": {
      "type": [
        "string",
        "null"
      ],
      "description": "Nome do Pai da pessoa"
    },
    "uf_inscricao": {
      "type": [
        "string",
        "null"
      ],
      "description": "UF(s) de inscrição do CPF."
    },
    "atualizado_em": {
      "type": [
        "string",
        "null"
      ],
      "format": "date",
      "description": "Data da última atualização deste registro na base de origem (AAAA-MM-DD) — leia como a recência da informação entregue."
    },
    "nacionalidade": {
      "type": [
        "string",
        "null"
      ],
      "description": "Nacionalidade da Pessoa"
    },
    "data_nascimento": {
      "type": [
        "string",
        "null"
      ],
      "description": "Data de Nascimento"
    },
    "data_inscricao_cpf": {
      "type": [
        "string",
        "null"
      ],
      "format": "date",
      "description": "Data de inscrição do CPF na Receita Federal."
    },
    "data_nascimento_br": {
      "type": [
        "string",
        "null"
      ],
      "description": "Data de Nascimento (dd/mm/yyyy)"
    },
    "situacao_cadastral": {
      "type": [
        "string",
        "null"
      ],
      "description": "Situação cadastral do CPF da pessoa"
    }
  }
}
```

## Observações

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> - Campos sem informação disponível no registro de origem são retornados como string vazia (`""`) em vez de `null`, o que ocorre com maior frequência no campo `nome_pai`.
> - Nomes, especialmente os de filiação, podem vir truncados em função do tamanho máximo permitido no registro de origem, portanto não são recomendados para comparação exata de strings.
> - As datas de nascimento e de inscrição seguem o padrão ISO 8601 com sufixo `Z` (UTC) e horário sempre `00:00:00Z`, já que apenas a data tem significado. O campo `atualizado_em` é entregue como data pura (`AAAA-MM-DD`): a fonte às vezes informa horário, que não é significativo e por isso não é repassado.
> - O campo `uf_inscricao` pode conter mais de uma UF concatenada quando o CPF foi emitido em uma região administrativa que agrupa vários estados.
> - A ausência de indicativo de óbito (`obito: false`) não garante que o titular esteja vivo — significa apenas que não há registro confirmado na base consultada.
> - CPFs com situação cadastral diferente de `REGULAR` devem receber tratamento específico no fluxo de negócio, pois indicam restrições ou pendências junto ao cadastro oficial.
> - Para análises de identidade e conformidade mais completas, recomenda-se combinar este endpoint com outras consultas de enriquecimento e verificação cadastral.
> - O campo `atualizado_em` diz quando este registro foi atualizado na base consultada: esta consulta serve o dado dessa base, não uma leitura ao vivo da Receita Federal. Se o seu caso exige o dado em TEMPO REAL, com comprovante emitido pela própria Receita (data/hora de emissão, código de controle e link de validação), use a consulta [Cadastro Pessoal com Receita Federal](https://fontedata.com/docs2/endpoints/pessoa-fisica/cadastro-rf-pf).

---

Página em HTML: https://fontedata.com/docs/pessoa-fisica/dados-cadastrais-basicos
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