# Cadastro Pessoal - Completo

> Retorna dados cadastrais completos de uma pessoa física a partir do CPF, incluindo informações pessoais, endereço, contatos, situação fiscal e óbito, integrados de múltiplas fontes oficiais.

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

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> Consulta os dados cadastrais registrados para um indivíduo a partir de seu CPF. Agrega informações coletadas em bases oficiais com dados complementares, permitindo acessar detalhes de identidade, localização, contato, perfil socioeconômico e relacionamentos familiares. O serviço é indicado para processos de verificação de identidade, avaliação de risco creditício, conformidade regulatória e prevenção a fraudes em fluxos de onboarding.

## Requisição

### cURL

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

### Python

```python
import requests

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

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:
>
> **Dados Pessoais**
> - `cpf`: Número do CPF consultado
> - `nome`: Nome completo registrado
> - `sexo`: Gênero do indivíduo
> - `dataNascimento`: Data de nascimento
> - `idade`: Idade calculada
> - `signo`: Signo zodiacal
> - `nomeMae`: Nome da mãe registrado
> - `nomePai`: Nome do pai registrado
>
> **Situação Cadastral**
> - `situacaoCadastral`: Status atual junto aos órgãos reguladores
> - `dataSituacaoCadastral`: Data da última atualização da situação
> - `obito`: Indicador booleano se há registro de óbito
> - `dataObito`: Data do óbito, quando registrado
>
> **Informações de Contato**
> - `telefones`: Lista de números de telefone vinculados, incluindo DDD, operadora, tipo (fixo ou celular) e flags indicando bloqueio para telemarketing ou associação com WhatsApp
> - `emails`: Lista de endereços de email registrados
>
> **Endereços**
> - `enderecos`: Lista de endereços vinculados ao CPF, incluindo logradouro, número, complemento, bairro, cidade, UF e CEP
>
> **Perfil Socioeconômico**
> - `rendaEstimada`: Renda presumida do indivíduo
> - `rendaFaixaSalarial`: Faixa salarial estimada em múltiplos de salário mínimo
> - `classeSocial`: Classificação socioeconômica
>
> **Ocupação**
> - `codigoCBO`: Código da Classificação Brasileira de Ocupações
> - `cbo`: Descrição da ocupação conforme classificação
>
> **Relacionamentos**
> - `parentescos`: Lista de pessoas relacionadas, contendo grau de parentesco, CPF, nome, data de nascimento, gênero, indicador de óbito e data do óbito quando aplicável

### Exemplo de resposta

```json
{
  "cbo": "string",
  "cpf": "string",
  "nome": "string",
  "sexo": "string",
  "idade": "number",
  "obito": "boolean",
  "signo": "string",
  "emails": [
    {
      "enderecoEmail": "string"
    }
  ],
  "nomeMae": "string",
  "nomePai": null,
  "codigoCBO": "string",
  "enderecos": [
    {
      "uf": "string",
      "cep": "string",
      "bairro": "string",
      "cidade": "string",
      "numero": "string",
      "logradouro": "string",
      "complemento": null
    }
  ],
  "telefones": [
    {
      "whatsApp": "boolean",
      "operadora": "string",
      "tipoTelefone": "string",
      "telefoneComDDD": "string",
      "telemarketingBloqueado": "boolean"
    }
  ],
  "parentescos": [
    {
      "cpf": "string",
      "nome": "string",
      "obito": "boolean",
      "genero": "string",
      "dataObito": null,
      "dataNascimento": "string",
      "grauParentesco": "string"
    }
  ],
  "classeSocial": "string",
  "rendaEstimada": "string",
  "dataNascimento": "string",
  "perfilDomiciliar": {
    "tipoDomicilio": "string",
    "confiabilidade": "string",
    "rendaPerCapita": "string",
    "rendaDomiciliar": "string",
    "quantidadeAdultos": "number",
    "quantidadeMenores": "number",
    "faixaRendaPerCapita": "string",
    "quantidadeMoradores": "number",
    "classeSocialFamiliar": "string"
  },
  "situacaoCadastral": "string",
  "rendaFaixaSalarial": "string",
  "dataSituacaoCadastral": "string"
}
```

### Schema da resposta

```json
{
  "type": "object",
  "properties": {
    "cbo": {
      "type": [
        "string",
        "null"
      ],
      "description": "Descrição da Classificação Brasileira de Ocupações."
    },
    "cpf": {
      "type": [
        "string",
        "null"
      ],
      "description": "CPF do indivíduo."
    },
    "nome": {
      "type": [
        "string",
        "null"
      ],
      "description": "Nome completo do indivíduo."
    },
    "sexo": {
      "type": [
        "string",
        "null"
      ],
      "description": "Gênero do indivíduo."
    },
    "idade": {
      "type": [
        "number",
        "null"
      ],
      "description": "Idade do indivíduo."
    },
    "obito": {
      "type": [
        "boolean",
        "null"
      ],
      "format": "bool",
      "description": "Indica se o indivíduo possui óbito registrado."
    },
    "signo": {
      "type": [
        "string",
        "null"
      ],
      "description": "Signo astrológico do indivíduo."
    },
    "emails": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "object",
        "properties": {
          "enderecoEmail": {
            "type": [
              "string",
              "null"
            ],
            "description": "Endereço de e-mail."
          }
        }
      },
      "description": "Lista de endereços de e-mail associados."
    },
    "nomeMae": {
      "type": [
        "string",
        "null"
      ],
      "description": "Nome da mãe do indivíduo."
    },
    "nomePai": {
      "type": [
        "string",
        "null"
      ],
      "description": "Nome do pai do indivíduo."
    },
    "codigoCBO": {
      "type": [
        "string",
        "null"
      ],
      "description": "Código da Classificação Brasileira de Ocupações."
    },
    "enderecos": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "object",
        "properties": {
          "uf": {
            "type": [
              "string",
              "null"
            ],
            "description": "Unidade Federativa do endereço."
          },
          "cep": {
            "type": [
              "string",
              "null"
            ],
            "description": "CEP do endereço."
          },
          "bairro": {
            "type": [
              "string",
              "null"
            ],
            "description": "Bairro do endereço."
          },
          "cidade": {
            "type": [
              "string",
              "null"
            ],
            "description": "Cidade do endereço."
          },
          "numero": {
            "type": [
              "string",
              "null"
            ],
            "description": "Número do endereço."
          },
          "logradouro": {
            "type": [
              "string",
              "null"
            ],
            "description": "Logradouro do endereço."
          },
          "complemento": {
            "type": [
              "string",
              "null"
            ],
            "description": "Complemento do endereço."
          }
        }
      },
      "x-display": "table",
      "description": "Lista de endereços associados ao indivíduo."
    },
    "telefones": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "object",
        "properties": {
          "whatsApp": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Indica se o telefone está vinculado ao WhatsApp."
          },
          "operadora": {
            "type": [
              "string",
              "null"
            ],
            "description": "Operadora do telefone."
          },
          "tipoTelefone": {
            "type": [
              "string",
              "null"
            ],
            "description": "Tipo de telefone (celular, residencial, etc)."
          },
          "telefoneComDDD": {
            "type": [
              "string",
              "null"
            ],
            "description": "Número de telefone incluindo DDD."
          },
          "telemarketingBloqueado": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Indica se o telefone está bloqueado para telemarketing."
          }
        }
      },
      "x-display": "table",
      "description": "Lista de telefones associados."
    },
    "parentescos": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "object",
        "properties": {
          "cpf": {
            "type": [
              "string",
              "null"
            ],
            "description": "CPF do parente."
          },
          "nome": {
            "type": [
              "string",
              "null"
            ],
            "description": "Nome do parente."
          },
          "obito": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Indica se o parente possui óbito registrado."
          },
          "genero": {
            "type": [
              "string",
              "null"
            ],
            "description": "Gênero do parente."
          },
          "dataObito": {
            "type": [
              "string",
              "null"
            ],
            "description": "Data do óbito do parente."
          },
          "dataNascimento": {
            "type": [
              "string",
              "null"
            ],
            "description": "Data de nascimento do parente."
          },
          "grauParentesco": {
            "type": [
              "string",
              "null"
            ],
            "description": "Grau de parentesco da pessoa relacionada."
          }
        }
      },
      "x-display": "table",
      "description": "Lista de dados de parentescos."
    },
    "classeSocial": {
      "type": [
        "string",
        "null"
      ],
      "description": "Classe social do indivíduo."
    },
    "rendaEstimada": {
      "type": [
        "string",
        "null"
      ],
      "description": "Renda estimada do indivíduo."
    },
    "dataNascimento": {
      "type": [
        "string",
        "null"
      ],
      "description": "Data de nascimento do indivíduo."
    },
    "perfilDomiciliar": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "tipoDomicilio": {
          "type": [
            "string",
            "null"
          ],
          "description": "Tipo de domicílio."
        },
        "confiabilidade": {
          "type": [
            "string",
            "null"
          ],
          "description": "Confiabilidade da estimativa."
        },
        "rendaPerCapita": {
          "type": [
            "string",
            "null"
          ],
          "format": "currency",
          "description": "Renda per capita estimada."
        },
        "rendaDomiciliar": {
          "type": [
            "string",
            "null"
          ],
          "format": "currency",
          "description": "Renda domiciliar estimada."
        },
        "quantidadeAdultos": {
          "type": [
            "number",
            "null"
          ],
          "description": "Quantidade de adultos no domicílio."
        },
        "quantidadeMenores": {
          "type": [
            "number",
            "null"
          ],
          "description": "Quantidade de menores no domicílio."
        },
        "faixaRendaPerCapita": {
          "type": [
            "string",
            "null"
          ],
          "description": "Faixa de renda per capita."
        },
        "quantidadeMoradores": {
          "type": [
            "number",
            "null"
          ],
          "description": "Quantidade total de moradores."
        },
        "classeSocialFamiliar": {
          "type": [
            "string",
            "null"
          ],
          "description": "Classe social familiar estimada."
        }
      },
      "description": "Perfil do domicílio do indivíduo (composição e renda familiar)."
    },
    "situacaoCadastral": {
      "type": [
        "string",
        "null"
      ],
      "description": "Situação cadastral do indivíduo."
    },
    "rendaFaixaSalarial": {
      "type": [
        "string",
        "null"
      ],
      "description": "Faixa de renda salarial baseada em salários mínimos."
    },
    "dataSituacaoCadastral": {
      "type": [
        "string",
        "null"
      ],
      "description": "Data da consulta da situação cadastral."
    }
  }
}
```

## Códigos de erro

| Código | Mensagem | Quando acontece |
|---|---|---|
| `400` | Requisição Inválida | a requisição está incorreta ou os parâmetros são inválidos. |
| `401` | Não Autenticado | o usuário não forneceu as credenciais corretas para acessar o recurso. |
| `403` | Não Autorizado | o servidor recebeu a requisição, mas se negou a autorizá-la por conta de saldo indisponível. |
| `404` | Não Encontrado | o servidor não encontrou uma representação atual do recurso solicitado. |
| `408` | Tempo Esgotado | o servidor não conseguiu retornar a requisição no prazo estabelecido. |
| `500` | Falha ao Realizar Consulta | o servidor não conseguiu processar a requisição com sucesso. Por favor, entre em contato com o nosso suporte. |
| `503` | Consulta em Manutenção | a consulta requisitada está em manutenção. Por favor, entre em contato com o nosso suporte. |

## Observações

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> A consulta retorna dados harmonizados de múltiplas fontes, combinando registros públicos com inferências analíticas. As informações podem variar em completude conforme a disponibilidade de dados para cada indivíduo. Campos como renda estimada, classe social e parentescos são baseados em modelos estatísticos e devem ser considerados indicativos e não definitivos para decisões críticas sem validação adicional. A data de atualização dos dados corresponde ao momento da consulta.

---

Página em HTML: https://fontedata.com/docs/pessoa-fisica/cadastro-pf-plus
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