# Como consultar o telefone e o e-mail de uma pessoa pelo CPF via API

> Versão em Markdown de https://datax.plus/guias/consultar-telefone-email-por-cpf-api/

Para recuperar o contato de um cliente, atualizar um cadastro ou fazer uma cobrança, a consulta por CPF resolve em uma chamada. Veja quando ela é adequada, o que considerar na LGPD e como integrar.

Por [Equipe DataX](https://datax.plus/) · Publicado em 4 de novembro de 2026 · 6 min de leitura

Resposta curta

Envie o CPF para `GET https://api.datax.plus/v1/pessoas/{cpf}/basico`, com a sua chave no cabeçalho `api-key`. A resposta traz, em JSON, os telefones encontrados, com indicação de WhatsApp, e os e-mails. Cada chamada consome 1 requisição do limite diário. Como são dados pessoais, defina antes a finalidade e a base legal do uso.

## Quando essa consulta é adequada

A consulta faz sentido quando você tem um motivo concreto para falar com aquela pessoa e o CPF já faz parte da relação. Os dados retornados são dados pessoais, então o motivo importa tanto quanto a integração.

| Uso | Exemplo | Avaliação |
| --- | --- | --- |
| Atualização de cadastro | O cliente trocou de número e a sua base ficou desatualizada | Adequado, com base legal definida |
| Cobrança | Recuperar o contato de quem tem uma dívida com a sua empresa | Adequado, com base legal definida |
| Escolha do canal | Ver quais números do cliente têm WhatsApp antes de escrever | Adequado, com base legal definida |
| Disparo em massa | Comprar uma lista de CPFs e mandar mensagens para todos | Evite |
| Curiosidade | Procurar o telefone de um conhecido ou de alguém que você não conhece | Não use |

## Finalidade e base legal

A LGPD exige uma base legal para cada tratamento de dados pessoais, e quem decide como os dados serão usados responde por essa escolha. O [artigo 7º da lei](https://www.planalto.gov.br/ccivil_03/_ato2015-2018/2018/lei/l13709.htm) lista as hipóteses. Estas costumam aparecer nesses casos:

| Base legal | Artigo | Situação típica |
| --- | --- | --- |
| Consentimento | 7º, I | A pessoa autorizou o uso do dado para aquela finalidade |
| Execução de contrato | 7º, V | O contato é necessário para cumprir um contrato com a pessoa, a pedido dela |
| Legítimo interesse | 7º, IX, e art. 10 | Há um interesse concreto da empresa, que não se sobrepõe aos direitos da pessoa e vem com transparência |
| Proteção do crédito | 7º, X | Consultas ligadas à concessão ou à recuperação de crédito |

A tabela é um ponto de partida, não um parecer: a base correta depende do seu caso, e o seu jurídico é quem deve definir. Registre a decisão e esteja pronto para atender a pessoa que pedir a correção dos dados ou se opuser ao uso (art. 18).

## Passo a passo

1. **Crie a conta e gere a chave.** [Cadastre-se no portal](https://portal.datax.plus/auth/cadastro) para o teste grátis de 24 horas, sem cartão, e gere a chave de API. Guarde a chave numa variável de ambiente.
2. **Limpe e valide o CPF.** Deixe só os 11 dígitos e confira os dígitos verificadores, para não fazer chamadas com um número digitado errado.
3. **Faça a chamada.** Um `GET` em `/v1/pessoas/{cpf}/basico`, com o cabeçalho `api-key`.
4. **Trate a resposta.** As listas podem vir vazias, e um mesmo CPF pode ter vários telefones.
5. **Grave a origem e a data.** Contatos mudam: saber quando foram consultados ajuda a decidir quando atualizar.

Para uma consulta pontual, sem programar, use o [portal](https://datax.plus/#portal): em Pesquisar dados, escolha Telefone e e-mail de um CPF e informe o CPF. A consulta conta nos limites do plano, como uma chamada à API.

## A chamada e a resposta

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

```json
{
  "cpf": "12345678909",
  "telefones": [
    {
      "ddd": "11",
      "numero": "9...",
      "numeroCompleto": "+55119...",
      "whatsapp": true
    }
  ],
  "emails": ["maria.o@..."]
}
```

| Campo | O que traz |
| --- | --- |
| `cpf` | CPF consultado |
| `telefones` | Lista de telefones, com DDD, número, número completo, tipo, operadora e se tem WhatsApp |
| `emails` | Lista de e-mails |

## Exemplo em Python

O exemplo valida o CPF antes de chamar a API e separa os números com WhatsApp dos demais.

```python
import os
import requests

KEY = os.environ["DATAX_KEY"]

def cpf_valido(cpf):
    if len(cpf) != 11 or not cpf.isdigit() or cpf == cpf[0] * 11:
        return False
    for n in (9, 10):
        soma = sum(int(cpf[i]) * (n + 1 - i) for i in range(n))
        if soma * 10 % 11 % 10 != int(cpf[n]):
            return False
    return True

def contatos(cpf):
    cpf = "".join(c for c in cpf if c.isdigit())
    if not cpf_valido(cpf):
        raise ValueError(f"CPF inválido: {cpf}")

    r = requests.get(
        f"https://api.datax.plus/v1/pessoas/{cpf}/basico",
        headers={"api-key": KEY},
        timeout=30,
    )
    r.raise_for_status()
    dados = r.json()

    telefones = dados.get("telefones") or []
    return {
        "whatsapp": [t["numeroCompleto"] for t in telefones if t.get("whatsapp")],
        "outros": [t["numeroCompleto"] for t in telefones if not t.get("whatsapp")],
        "emails": dados.get("emails") or [],
    }

print(contatos("123.456.789-09"))
```

## Qual consulta usar

| Você tem | Quer | Consulta |
| --- | --- | --- |
| CPF | Só o contato | [Telefone e e-mail por CPF](https://datax.plus/api-telefone-email-cpf/) |
| CPF | Contato e cadastro: nome, nascimento, situação na Receita, óbito e endereços | [Ficha do CPF](https://datax.plus/api-consulta-cpf/) |
| Só o nome | Encontrar o CPF | [Busca por nome](https://datax.plus/api-busca-pessoa-nome/) |
| Telefone | Saber de quem é o número | [Reverso de telefone](https://datax.plus/api-reverso-telefone/) |
| E-mail | Saber de quem é o endereço | [Reverso de e-mail](https://datax.plus/api-reverso-email/) |
| CNPJ | O contato dos sócios | [Sócios de um CNPJ](https://datax.plus/api-socios-cnpj/) |

As consultas por CPF consomem 1 requisição cada uma. Se você vai usar também o cadastro, prefira a ficha, que traz tudo na mesma chamada.

## Erros mais comuns

| Resposta | O que significa | O que fazer |
| --- | --- | --- |
| `401` | Chave ausente, inválida ou com formato errado | Confira o cabeçalho `api-key` |
| `403` | A consulta não está no seu plano. Não consome requisições | Veja os [planos](https://datax.plus/#planos) |
| `422` | Parâmetros faltando ou inválidos | Confira se o CPF tem 11 dígitos, só números |
| Listas vazias | Não há contato encontrado para aquele CPF | Trate como resultado normal, não como erro |

A [documentação](https://datax.plus/docs/#erros) mostra o formato completo dos erros.

## Boas práticas

- Peça só o que vai usar: se precisa apenas do contato, não consulte a ficha inteira.
- Guarde o resultado e não consulte o mesmo CPF de novo sem motivo.
- Mantenha a chave no servidor, nunca no navegador ou no aplicativo.
- Limite quem pode ver os dados na sua empresa e registre quem consultou o quê.
- Ofereça uma forma simples de a pessoa pedir para não ser mais contatada, e respeite o pedido.

## Dúvidas sobre a consulta de telefone por CPF

### É legal consultar o telefone de alguém pelo CPF?

Depende da finalidade. Pela LGPD, o uso de dados pessoais precisa de uma base legal, como o consentimento, a execução de um contrato, o legítimo interesse ou a proteção do crédito. Atualizar o cadastro de um cliente é diferente de procurar o contato de um desconhecido. Na dúvida, fale com o seu jurídico.

### A Receita Federal informa o telefone pelo CPF?

Não. A consulta pública de CPF da Receita mostra a situação cadastral, não os contatos da pessoa.

### Existe consulta gratuita de telefone por CPF?

A DataX tem teste grátis de 24 horas, sem cartão, com 20 chamadas. Depois, a consulta está em todos os planos, a partir de R$ 99/mês, com 1.000 chamadas por dia.

### A consulta mostra se o número tem WhatsApp?

Sim. Cada telefone traz o campo `whatsapp`, além de DDD, número, número completo, tipo e operadora.

### Todo CPF retorna telefone e e-mail?

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

### Consigo consultar sem ter uma chave de API?

Não. Toda chamada precisa da chave no cabeçalho `api-key`. Você gera a chave no portal, depois de criar a conta.

## Faça a primeira consulta hoje, com o teste grátis de 24 horas, sem cartão.

[Começar teste grátis](https://portal.datax.plus/auth/cadastro) [Ver a API de contatos](https://datax.plus/api-telefone-email-cpf/)