Documentação da API
Consulte CPF, CNPJ, telefone, placa e mais via uma API REST simples. Autenticação por token Bearer, resposta JSON estruturada. Integração em minutos.
Autenticação
Todas as requisições exigem o header Authorization: Bearer dp_live_… — gere seu token no dashboard após ativar um plano. Nunca envie o token em query string.
Endpoints
| Método | Endpoint | Descrição |
|---|---|---|
| POST | /api/v1/consultas/cpf | Identificação por CPF |
| POST | /api/v1/consultas/nome | Busca por nome completo |
| POST | /api/v1/consultas/telefone | Busca reversa por telefone |
| POST | /api/v1/consultas/email | Busca reversa por e-mail |
| POST | /api/v1/consultas/rg | Busca reversa por RG |
| POST | /api/v1/consultas/placa | Dossiê veicular por placa |
| POST | /api/v1/consultas/cnpj | Dados empresariais por CNPJ |
| POST | /api/v1/consultas/ip | Geolocalização e ISP por IP |
| GET | /api/v1/consultas/cep/{cep} | Endereço por CEP (grátis) |
Exemplos
cURL
curl -X POST "https://apiconsultas.xyz/api/v1/consultas/cpf" \
-H "Authorization: Bearer dp_live_xxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"cpf": "00000000000"}'JavaScript / Node
const res = await fetch("https://apiconsultas.xyz/api/v1/consultas/nome", {
method: "POST",
headers: {
Authorization: "Bearer dp_live_xxxxxxxxxxxxxxxxx",
"Content-Type": "application/json",
},
body: JSON.stringify({ nome: "Nome Completo" }),
});
const data = await res.json();PHP
<?php
$ch = curl_init("https://apiconsultas.xyz/api/v1/consultas/cnpj");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer dp_live_xxxxxxxxxxxxxxxxx",
"Content-Type: application/json",
],
CURLOPT_POSTFIELDS => json_encode(["cnpj" => "00000000000000"]),
]);
$data = json_decode(curl_exec($ch), true);Python
import requests
r = requests.post(
"https://apiconsultas.xyz/api/v1/consultas/cpf",
headers={"Authorization": "Bearer dp_live_xxxxxxxxxxxxxxxxx"},
json={"cpf": "00000000000"},
timeout=30,
)
print(r.json())Resposta 200
{
"consulta_id": "uuid",
"tipo_consulta": "cpf",
"resultado_count": 1,
"permission_badge": "Elite — dados completos",
"data_quality": { "sources_used": 3, "confidence_score": 90 },
"data": [{ "identificacao": { "nome": "...", "documento": "..." } }]
}Códigos de erro
| Status | Código | Causa |
|---|---|---|
| 401 | unauthorized | Token ausente, inválido ou revogado |
| 402 | payment_required | Assinatura inativa ou expirada |
| 403 | forbidden | Plano de teste sem API, escopo do token ou permissão |
| 429 | rate_limited | Muitas requisições por minuto |
| 504 | query_timeout | Tempo limite da consulta excedido |
Pronto para produção em minutos
Ative um plano, gere seu token Bearer e comece a integrar. Consultas ilimitadas enquanto o plano estiver ativo.