API de telefone e e-mail por CPF
Envie um CPF e receba, em JSON, só os contatos da pessoa: os telefones, com DDD, operadora e indicação de WhatsApp, e os e-mails. É a consulta para quando você já tem o cadastro e quer apenas o contato.
curl https://api.datax.plus/v1/pessoas/12345678909/basico \ -H "api-key: $DATAX_KEY"
const res = await fetch(
"https://api.datax.plus/v1/pessoas/12345678909/basico",
{ headers: { "api-key": KEY } }
);
const data = await res.json();
import requests
r = requests.get(
"https://api.datax.plus/v1/pessoas/12345678909/basico",
headers={"api-key": KEY},
)
data = r.json()
{
"cpf": "12345678909",
"telefones": [
{ "ddd": "11", "numero": "9...", "numeroCompleto": "+55119...", "whatsapp": true }
],
"emails": ["maria.o@..."]
}
Onde a consulta de contatos entra
-
Cobrança e recuperação de contato
Recupere o contato de clientes que trocaram de telefone ou de e-mail, a partir do CPF.
-
Atualização de CRM
Mantenha os contatos da sua base em dia, sem pagar pela ficha completa a cada atualização.
Guia de CRM → -
Escolha do canal
Veja quais telefones têm WhatsApp antes de decidir como falar com o cliente.
-
Plataformas SaaS
Ofereça o enriquecimento de contatos como recurso da sua plataforma, integrado por API.
Requisição e resposta
O exemplo é resumido e usa valores fictícios. As listas podem vir vazias quando não há contato encontrado.
- 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 o CPF e os contatos. - Consumo
- 1 requisição do limite diário por chamada.
- MCP
- Agentes de IA usam esta consulta pela ferramenta
contatos_cpfdo servidor MCP.
| 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 |
Planos com a consulta de contatos
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.
| 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 telefone e e-mail por CPF
Como descobrir o telefone de uma pessoa pelo CPF via API?
Envie o CPF para GET /v1/pessoas/{cpf}/basico, com a sua chave no cabeçalho api-key. A resposta traz os telefones e os e-mails encontrados, em JSON.
Quanto custa?
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 ficha do CPF?
Esta consulta traz só os contatos. A ficha do CPF traz também nome, data de nascimento, situação na Receita, indicação de óbito e endereços.
A API mostra se o telefone tem WhatsApp?
Sim. Cada telefone traz o campo whatsapp, além de DDD, número, número completo, tipo e operadora.
Todo CPF vem com telefone e e-mail?
Nem sempre. Trate telefones e emails 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 consulta de CPF
Dados cadastrais, telefones, e-mails e endereços da pessoa.
-
API de reverso de telefone
Titular, CPF, operadora e WhatsApp de um número.
-
API de sócios de um CNPJ
Telefone e e-mail de cada sócio pessoa física da empresa.