API de consulta de CPF

Documentação da API de consulta de CPF

Referência da chamada usada por empresas que validam CPF no cadastro, no checkout e no antifraude.

A consulta confere nome, nascimento e nome da mãe antes de aprovar um cadastro ou um pagamento. O plano gratuito tem 10 consultas por mês; os planos pagos incluem 10.000 e o excedente sai a R$ 0,01 no PIX.

Chamada

GET https://api.cpf-brasil.org/cpf/00000000191

Header X-API-Key: SEU_TOKEN. O mesmo token também vale em Authorization: Bearer SEU_TOKEN.

curl -H "X-API-Key: SEU_TOKEN" \
  "https://api.cpf-brasil.org/cpf/00000000191"

Resposta

JSON com success e data. Campos de data:

• CPF — os 11 dígitos consultados
• NOME — nome em title case
• SEXO — Masculino ou Feminino
• NASC — data no formato DD/MM/AAAA
• NOME_MAE — nome da mãe

A resposta não inclui situação cadastral ao vivo, score de crédito, endereço, telefone nem e-mail. Não é o serviço do Serpro.

Cota

• Plano gratuito: 10 consultas por mês
• Planos pagos: 10.000 consultas por mês incluídas
• Excedente: R$ 0,01 por consulta, cobrado por PIX no dashboard

O token é gerado em criar conta.

Exemplos

# Python
import requests
r = requests.get(
    "https://api.cpf-brasil.org/cpf/00000000191",
    headers={"X-API-Key": "SEU_TOKEN"},
    timeout=10,
)
print(r.json()["data"]["NOME"])

// JavaScript
const r = await fetch("https://api.cpf-brasil.org/cpf/00000000191", {
  headers: { "X-API-Key": "SEU_TOKEN" },
});
const body = await r.json();
console.log(body.data.NOME);

// PHP
$ch = curl_init("https://api.cpf-brasil.org/cpf/00000000191");
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => ["X-API-Key: SEU_TOKEN"],
    CURLOPT_RETURNTRANSFER => true,
]);
$body = json_decode(curl_exec($ch), true);
echo $body["data"]["NOME"];