# API de consulta de CPF

> Versão em Markdown de https://datax.plus/api-consulta-cpf/

Envie um CPF e receba, em JSON, o nome, a data de nascimento, a situação na Receita Federal, a indicação de óbito, os telefones, os e-mails e os endereços da pessoa. Cada consulta consome 1 requisição do seu limite diário.

[Testar grátis por 24h](https://portal.datax.plus/auth/cadastro) [Ver na documentação](https://datax.plus/docs/#ficha-cpf)

● Teste grátis por 24 horas, sem cartão · depois, a partir de R$ 99/mês, sem fidelidade

```bash
curl https://api.datax.plus/v1/pessoas/12345678909 \
  -H "api-key: $DATAX_KEY"
```

```javascript
const res = await fetch(
  "https://api.datax.plus/v1/pessoas/12345678909",
  { headers: { "api-key": KEY } }
);
const data = await res.json();
```

```python
import requests

r = requests.get(
    "https://api.datax.plus/v1/pessoas/12345678909",
    headers={"api-key": KEY},
)
data = r.json()
```

```json
{
  "cpf": "12345678909",
  "nome": "MARIA S. OLIVEIRA",
  "dataNascimento": "1988-03-14",
  "situacaoCadastral": "REGULAR",
  "falecido": false,
  "telefones": [
    { "ddd": "11", "numero": "9...", "numeroCompleto": "+55119...", "whatsapp": true }
  ],
  "emails": ["maria.o@..."],
  "enderecos": [
    { "logradouro": "...", "numero": "...", "bairro": "...", "municipio": "SÃO PAULO", "uf": "SP", "cep": "..." }
  ]
}
```

## Onde a consulta de CPF entra

- **Cadastro de clientes**

  Confira o nome e a data de nascimento informados e complete o cadastro a partir do CPF.

- **Conferência antes de aprovar**

  Veja a situação do CPF na Receita Federal e se há registro de óbito antes de aprovar um cadastro.

- **Cobrança e recuperação de contato**

  Atualize telefones, e-mails e endereços de clientes com o cadastro desatualizado.

- **CRM e automação**

  Complete leads e contatos assim que o CPF entra no sistema, por API ou com n8n, Make e Zapier.

  [Guia de CRM →](https://datax.plus/guias/enriquecer-crm-n8n-make-zapier/)

## Requisição e resposta

O exemplo é resumido e usa valores fictícios; a resposta pode trazer campos além dos listados. Campos sem informação podem vir como `null` ou como lista vazia.

**GET** `https://api.datax.plus/v1/pessoas/{cpf}`

- **Cabeçalho**: `api-key`: a chave de API gerada no portal. Obrigatório em todas as chamadas.
- **Caminho**: `cpf`: o CPF da pessoa, com 11 dígitos, só números.
- **Resposta**: JSON (`application/json`) com a ficha da pessoa.
- **Consumo**: 1 requisição do limite diário por chamada.
- **MCP**: Agentes de IA usam esta consulta pela ferramenta `ficha_cpf` do [servidor MCP](https://datax.plus/docs/#mcp).

Por [Equipe DataX](https://datax.plus/) · Atualizada em 4 de novembro de 2026

| Campo | O que traz |
| --- | --- |
| `cpf`, `nome` | CPF consultado e nome completo |
| `dataNascimento`, `sexo` | Data de nascimento e sexo |
| `situacaoCadastral` | Situação do CPF na Receita Federal |
| `falecido`, `dataObito` | Indicação de óbito e a data, quando houver |
| `telefones` | Lista de telefones, com DDD, número, número completo, tipo, operadora e se tem WhatsApp |
| `emails` | Lista de e-mails |
| `enderecos` | Lista de endereços, com logradouro, número, complemento, bairro, município, UF e CEP |

[Ver na documentação completa →](https://datax.plus/docs/#ficha-cpf)

## Planos com a consulta de CPF

Cada consulta consome 1 requisição do limite diário. Ela está no teste grátis e em todos os planos, sem fidelidade e com pagamento por Pix. [Ver todos os planos](https://datax.plus/#planos).

| Plano | Preço | Chamadas/dia | Chamadas/min | Custo por chamada |
| --- | --- | --- | --- | --- |
| Teste 24 horas | Grátis | 20 no período | 20 | Grátis |
| Entrada | R$ 99/mês | 1.000 | 30 | R$ 0,0033 |
| Intermediário | R$ 299/mês | 5.000 | 120 | R$ 0,0020 |
| Avançado | R$ 599/mês | 20.000 | 300 | R$ 0,0010 |

O custo por chamada considera o uso de todo o limite diário por 30 dias.

## Perguntas sobre a API de consulta de CPF

### Quais dados a consulta de CPF retorna?

Nome, data de nascimento, sexo, situação do CPF na Receita Federal, indicação de óbito, telefones, e-mails e endereços da pessoa. A resposta vem em JSON.

### Quanto custa consultar um CPF por API?

Cada consulta consome 1 requisição do limite diário do plano. A consulta está no teste grátis de 24 horas (20 chamadas) e em todos os planos: Entrada (R$ 99/mês, 1.000 chamadas/dia), Intermediário (R$ 299/mês, 5.000) e Avançado (R$ 599/mês, 20.000). Usando todo o limite diário por 30 dias, cada chamada sai por cerca de R$ 0,0033, R$ 0,0020 e R$ 0,0010, respectivamente.

### Qual a diferença para a consulta de telefone e e-mail por CPF?

A ficha do CPF traz o cadastro completo, com endereços e situação na Receita. A [consulta de telefone e e-mail](https://datax.plus/api-telefone-email-cpf/) traz só os contatos, para quando você já tem o cadastro.

### Como saber se a pessoa faleceu?

Pelos campos `falecido`, que indica o óbito, e `dataObito`, que traz a data quando houver.

### Todo CPF vem com telefone e e-mail?

Nem sempre. Trate `telefones`, `emails` e `enderecos` como listas que podem vir vazias.

### Posso usar esses dados de acordo com a LGPD?

Os dados retornados são dados pessoais. Pela LGPD, cada uso precisa de uma finalidade legítima e de uma base legal, como o legítimo interesse ou a proteção do crédito, e cabe a cada empresa definir as duas para o seu caso. Na dúvida, fale com o seu jurídico.

## Outras consultas da API

- **[API de telefone e e-mail por CPF](https://datax.plus/api-telefone-email-cpf/)**

  Só os contatos da pessoa, sem o restante da ficha.

- **[API de busca por nome](https://datax.plus/api-busca-pessoa-nome/)**

  Candidatos com CPF, data de nascimento e UF.

- **[API de consulta de CNPJ](https://datax.plus/api-consulta-cnpj/)**

  Ficha cadastral da empresa e quadro societário.

[Ver todas as consultas na documentação →](https://datax.plus/docs/)

Guias: [telefone e e-mail por CPF →](https://datax.plus/guias/consultar-telefone-email-por-cpf-api/) · [como escolher uma API →](https://datax.plus/guias/como-escolher-api-cpf-cnpj/)

## Teste a consulta de CPF grátis por 24 horas, sem cartão.

[Começar teste grátis](https://portal.datax.plus/auth/cadastro) [Ver na documentação](https://datax.plus/docs/#ficha-cpf)