# Cadastro Pessoal - Telefones e endereços

> Consulta dados cadastrais de um CPF, retornando informações pessoais, endereço e contato de fontes oficiais. Aplicável para verificação de identidade, análise de risco e prevenção a fraude.

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

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> Recupera informações cadastrais completas associadas a um CPF, integrando dados de múltiplas fontes públicas e complementando-os com inferências e correlações. É essencial para fluxos de verificação de identidade, análise de perfil de risco e decisões de crédito automatizadas.
>
> **Casos de uso:**
> - Onboarding de clientes e fornecedores com validação de identidade
> - Avaliação de risco e elegibilidade para crédito
> - Detecção de inconsistências e possíveis fraudes
> - Segmentação de públicos baseada em perfil socioeconômico
>
> **Benefícios:**
> - Reduz atritos operacionais mediante automação de decisões
> - Melhora a confiabilidade na identificação de pessoas
> - Acelera aprovações ao diminuir etapas manuais de validação
> - Fortalece conformidade com regulamentações internas e proteção de dados

## Requisição

### cURL

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

### Python

```python
import requests

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

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 um objeto contendo as seguintes informações:
>
> **Dados Pessoais:**
> - `cpf` — Número de CPF
> - `nome` — Nome completo registrado
> - `sexo` — Gênero declarado
> - `dataNascimento` — Data de nascimento
> - `idade` — Idade calculada
> - `signo` — Signo zodiacal correspondente
> - `nomeMae` — Nome da mãe
>
> **Contato:**
> - `emails` — Lista de endereços de e-mail associados
> - `telefones` — Números de telefone registrados, com informações como operadora, classificação (fixo/celular), bloqueio para telemarketing e vinculação com WhatsApp
>
> **Localização:**
> - `enderecos` — Lista de endereços, incluindo logradouro, número, complemento, bairro, cidade, estado (UF) e CEP
>
> **Dados Econômicos:**
> - `rendaEstimada` — Estimativa de renda mensal ou anual
> - `rendaFaixaSalarial` — Faixa salarial correspondente

### Exemplo de resposta

```json
{
  "cpf": "***",
  "nome": "***",
  "sexo": "***",
  "idade": 0,
  "signo": "ESCORPIAO",
  "emails": [
    {
      "enderecoEmail": "***"
    },
    {
      "enderecoEmail": "***"
    },
    {
      "enderecoEmail": "***"
    }
  ],
  "nomeMae": "***",
  "enderecos": [
    {
      "uf": "GO",
      "cep": "***",
      "bairro": "***",
      "cidade": "GOIANIA",
      "numero": "815",
      "logradouro": "***",
      "complemento": "***"
    },
    {
      "uf": "GO",
      "cep": "***",
      "bairro": "***",
      "cidade": "GOIANIA",
      "numero": "132007",
      "logradouro": "***",
      "complemento": "***"
    },
    {
      "uf": "GO",
      "cep": "***",
      "bairro": "***",
      "cidade": "GOIANIA",
      "numero": "1",
      "logradouro": "***",
      "complemento": null
    }
  ],
  "telefones": [
    {
      "whatsApp": true,
      "operadora": "CLARO",
      "tipoTelefone": "TELEFONE MÓVEL",
      "telefoneComDDD": "***",
      "telemarketingBloqueado": null
    },
    {
      "whatsApp": true,
      "operadora": "CLARO",
      "tipoTelefone": "TELEFONE MÓVEL",
      "telefoneComDDD": "***",
      "telemarketingBloqueado": false
    },
    {
      "whatsApp": true,
      "operadora": "CLARO",
      "tipoTelefone": "TELEFONE MÓVEL",
      "telefoneComDDD": "***",
      "telemarketingBloqueado": null
    },
    {
      "whatsApp": true,
      "operadora": "CLARO",
      "tipoTelefone": "TELEFONE MÓVEL",
      "telefoneComDDD": "***",
      "telemarketingBloqueado": null
    },
    {
      "whatsApp": true,
      "operadora": "CLARO",
      "tipoTelefone": "TELEFONE MÓVEL",
      "telefoneComDDD": "***",
      "telemarketingBloqueado": null
    }
  ],
  "rendaEstimada": "***",
  "dataNascimento": "***",
  "rendaFaixaSalarial": "Faixa 11 a 15 salários mínimos"
}
```

### Schema da resposta

```json
{
  "type": "object",
  "properties": {
    "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 em anos."
    },
    "signo": {
      "type": [
        "string",
        "null"
      ],
      "description": "Signo zodiacal 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 vinculados."
    },
    "nomeMae": {
      "type": [
        "string",
        "null"
      ],
      "description": "Nome da mãe do indivíduo."
    },
    "enderecos": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "object",
        "properties": {
          "uf": {
            "type": [
              "string",
              "null"
            ],
            "description": "Unidade Federativa (estado)."
          },
          "cep": {
            "type": [
              "string",
              "null"
            ],
            "description": "Código de Endereçamento Postal."
          },
          "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 imóvel."
          },
          "logradouro": {
            "type": [
              "string",
              "null"
            ],
            "description": "Nome da rua, avenida ou logradouro."
          },
          "complemento": {
            "type": [
              "string",
              "null"
            ],
            "description": "Complemento do endereço."
          }
        }
      },
      "x-display": "table",
      "description": "Lista de endereços cadastrados."
    },
    "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 de telefonia."
          },
          "tipoTelefone": {
            "type": [
              "string",
              "null"
            ],
            "description": "Tipo de telefone (fixo, móvel, 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 vinculados."
    },
    "rendaEstimada": {
      "type": [
        "string",
        "null"
      ],
      "description": "Renda estimada do indivíduo."
    },
    "dataNascimento": {
      "type": [
        "string",
        "null"
      ],
      "description": "Data de nascimento do indivíduo."
    },
    "rendaFaixaSalarial": {
      "type": [
        "string",
        "null"
      ],
      "description": "Faixa salarial estimada."
    }
  }
}
```

## 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.
>
> - Esta consulta retorna dados consolidados de múltiplas fontes oficiais. A precisão das informações depende da atualização e disponibilidade nos registros públicos.
> - Campos podem estar vazios ou ausentes caso não haja dados disponíveis para aquele indivíduo naquele atributo específico.
> - O endpoint é recomendado para contextos de verificação de identidade e análise de risco, não como fonte única de verdade para decisões críticas.
> - Considere sempre validar informações sensíveis através de canais secundários quando a transação implicar em alto risco ou valor significativo.

---

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