# Validação Cadastral - Brasil

> Valida e consulta dados cadastrais de um CPF, retornando informações pessoais, endereço, telefone, e-mail e faixa salarial. Utilizado para onboarding, validação de identidade, análise de risco e preve

- **Consulta:** `registration-brazil`
- **Categoria:** Antifraude
- **Preço:** R$ 0,43 por consulta
- **Endpoint:** `GET https://app.fontedata.com/api/v1/consulta/registration-brazil`
- **Autenticação:** header `X-API-Key`
- **Página:** https://fontedata.com/docs/antifraude/registration-brazil

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> Este endpoint realiza consultas de dados cadastrais de pessoas físicas no Brasil. Permite recuperar informações pessoais e socioeconômicas associadas a um CPF, incluindo identificação, contato, endereços e faixa de renda.
>
> **Casos de uso:**
>
> - Onboarding e validação de identidade em processos de contas
> - Análise de risco de crédito utilizando dados socioeconômicos
> - Detecção de fraude em cadastramentos e aberturas de conta
> - Conformidade regulatória e verificação de dados cadastrais
> - Análise ESG e compliance com políticas internas
>
> **Benefícios:**
>
> - Dados padronizados e atualizados regularmente
> - Redução de atrito no processo de aprovação
> - Conformidade com diretrizes internas e legislação de proteção de dados
> - Informações estruturadas para decisões de negócio mais precisas

## Requisição

### cURL

```bash
curl -H "X-API-Key: SUA_CHAVE" \
  "https://app.fontedata.com/api/v1/consulta/registration-brazil?cpf=SEU_CPF&name=SEU_NOME&surname=SEU_SOBRENOME"
```

### Python

```python
import requests

resp = requests.get(
    "https://app.fontedata.com/api/v1/consulta/registration-brazil",
    params={"cpf": "SEU_CPF", "name": "SEU_NOME", "surname": "SEU_SOBRENOME"},
    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/registration-brazil");

url.search = new URLSearchParams({
  "cpf": "SEU_CPF",
  "name": "SEU_NOME",
  "surname": "SEU_SOBRENOME"
}).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 |
| `dob` | texto | não | Data de nascimento do titular (DD/MM/AAAA). Parâmetro opcional que pode ser combinado com `name` e `surname` para reforçar a identificação do CPF consultado. | — |
| `name` | texto | não | Nome completo do titular. Parâmetro opcional que pode ser combinado com `surname` e `dob` para reforçar a identificação do CPF consultado. | formato: Nome completo |
| `surname` | texto | não | Sobrenome do titular. Parâmetro opcional que pode ser combinado com `name` e `dob` para reforçar a identificação do CPF consultado. | formato: Sobrenome |

## Resposta

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> A consulta retorna um objeto estruturado contendo:
>
> - **Identificação:** Nome, data de nascimento, gênero, idade, CPF, nome da mãe
> - **Contato:** Lista de telefones (com tipo de linha) e endereços de e-mail
> - **Endereço:** Rua, número, complemento, bairro, cidade, estado e código postal
> - **Dados socioeconômicos:** Faixa salarial e renda estimada
>
> Todos os campos relacionados a telefones, endereços e e-mails são retornados como listas, permitindo múltiplos registros para cada tipo de informação.

### Exemplo de resposta

```json
{
  "age": 38,
  "cpf": "***",
  "name": "***",
  "emails": [
    {
      "emailAddress": "***"
    },
    {
      "emailAddress": "***"
    }
  ],
  "gender": "Feminino",
  "phones": [
    {
      "phoneType": null,
      "phoneNumber": "(11) 991000001"
    },
    {
      "phoneType": null,
      "phoneNumber": "(11) 991000002"
    },
    {
      "phoneType": null,
      "phoneNumber": "(11) 991000003"
    },
    {
      "phoneType": null,
      "phoneNumber": "(11) 32100004"
    },
    {
      "phoneType": null,
      "phoneNumber": "(11) 32100005"
    }
  ],
  "addresses": [
    {
      "city": "JUIZ DE FORA",
      "state": "MG",
      "number": "212",
      "street": "RUA DAS FLORES",
      "complement": null,
      "postalCode": "36010-020",
      "neighborhood": "SAO MATEUS"
    },
    {
      "city": "JUIZ DE FORA",
      "state": "MG",
      "number": "530",
      "street": "AVENIDA RIO BRANCO",
      "complement": "AP 305",
      "postalCode": "36016-310",
      "neighborhood": "CENTRO"
    },
    {
      "city": "NITEROI",
      "state": "RJ",
      "number": "220",
      "street": "RUA VISCONDE DE SEPETIBA",
      "complement": "BL 2 AP 402",
      "postalCode": "24020-207",
      "neighborhood": "ICARAI"
    }
  ],
  "nameMother": "***",
  "dateOfBirth": "***",
  "salaryRange": "1518",
  "estimatedSalary": "Faixa 1 salário mínimo"
}
```

### Schema da resposta

```json
{
  "type": "object",
  "properties": {
    "age": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Idade do indivíduo."
    },
    "cpf": {
      "type": [
        "string",
        "null"
      ],
      "description": "CPF do indivíduo."
    },
    "name": {
      "type": [
        "string",
        "null"
      ],
      "description": "Nome do indivíduo."
    },
    "emails": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "object",
        "properties": {
          "emailAddress": {
            "type": [
              "string",
              "null"
            ],
            "description": "Endereço de e-mail."
          }
        }
      },
      "description": "Lista de endereços de e-mail."
    },
    "gender": {
      "type": [
        "string",
        "null"
      ],
      "description": "Gênero do indivíduo."
    },
    "phones": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "object",
        "properties": {
          "phoneType": {
            "type": [
              "string",
              "null"
            ],
            "description": "Tipo de telefone."
          },
          "phoneNumber": {
            "type": [
              "string",
              "null"
            ],
            "description": "Número de telefone com DDD."
          }
        }
      },
      "x-display": "table",
      "description": "Lista de telefones."
    },
    "addresses": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "object",
        "properties": {
          "city": {
            "type": [
              "string",
              "null"
            ],
            "description": "Cidade."
          },
          "state": {
            "type": [
              "string",
              "null"
            ],
            "description": "Estado."
          },
          "number": {
            "type": [
              "string",
              "null"
            ],
            "description": "Número do endereço."
          },
          "street": {
            "type": [
              "string",
              "null"
            ],
            "description": "Nome da rua, avenida ou logradouro."
          },
          "complement": {
            "type": [
              "string",
              "null"
            ],
            "description": "Complemento do endereço."
          },
          "postalCode": {
            "type": [
              "string",
              "null"
            ],
            "description": "Código postal (CEP)."
          },
          "neighborhood": {
            "type": [
              "string",
              "null"
            ],
            "description": "Bairro."
          }
        }
      },
      "x-display": "table",
      "description": "Lista de endereços."
    },
    "nameMother": {
      "type": [
        "string",
        "null"
      ],
      "description": "Nome da mãe do indivíduo."
    },
    "dateOfBirth": {
      "type": [
        "string",
        "null"
      ],
      "format": "date",
      "description": "Data de nascimento do indivíduo."
    },
    "salaryRange": {
      "type": [
        "string",
        "null"
      ],
      "format": "currency",
      "description": "Renda estimada"
    },
    "estimatedSalary": {
      "type": [
        "string",
        "null"
      ],
      "description": "Faixa salarial"
    }
  }
}
```

## 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.
>
> - Cada requisição deve conter apenas um documento/indivíduo
> - Os dados retornados refletem informações disponíveis nos registros consultados
> - A consulta pode não retornar resultados positivos se o CPF não estiver cadastrado ou se os dados pessoais não corresponderem aos registros disponíveis
> - Para melhor aproveitamento, forneça informações precisas nos parâmetros de entrada
> - Em caso de dúvidas sobre interpretação dos dados ou funcionamento da consulta, consulte a documentação técnica adicional

---

Página em HTML: https://fontedata.com/docs/antifraude/registration-brazil
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