Como consultar CPF com API: guia completo

O que você precisa antes de começar

• Conta em app.apicpf.dev
• Uma chave de API gerada no painel
• O CPF a consultar (apenas números ou formatado)

1. Autentique a requisição

A forma mais comum é enviar a chave no header X-API-KEY. Também é possível usar Bearer ou ?token= na URL.

X-API-KEY: sua_chave_aqui

2. Faça a consulta

Chame o endpoint de consulta com o CPF:

GET /consulta?cpf=00000000000

A API consulta múltiplos provedores em paralelo e devolve um JSON estável — ideal para onboarding e KYC.

3. Exemplo com cURL

curl -X GET "https://apicpf.dev/consulta?cpf=00000000000" \
  -H "X-API-KEY: sua_chave_aqui"

4. Resposta esperada

O retorno traz campos como cpf, nome, mae, genero e data_nascimento, prontos para preencher formulários e validar identidade.

{
  "code": 200,
  "data": {
    "cpf": "00000000000",
    "nome": "NOME COMPLETO",
    "mae": "NOME DA MAE",
    "genero": "M",
    "data_nascimento": "01/01/1990"
  }
}

Boas práticas de integração

• Valide o CPF localmente ou via endpoint de validação antes da consulta completa.
• Guarde a chave no servidor — nunca no front público.
• Trate timeouts e códigos de erro de forma previsível no fluxo do usuário.
• Use o painel para acompanhar volume e consumo.

Por que usar uma API de CPF

Consulta manual não escala. Com a API CPF você reduz tempo de integração, mantém latência baixa (~2ms em média) e padroniza o contrato JSON para qualquer stack — Node, PHP, Python, Go ou Java.

Perguntas frequentes

Como consultar CPF com API?

Envie X-API-KEY e faça GET /consulta?cpf=. A resposta vem em JSON com os dados cadastrais.

A API CPF é rápida o bastante para o front?

Sim. A latência média em torno de 2ms permite consultar sem travar cadastro ou checkout.