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

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.

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 lista as hipóteses. Estas costumam aparecer nesses casos:

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 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.

A chamada e a resposta

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

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

Exemplo em Python

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

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

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

A documentação 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.