curl

Consulte CPF direto do terminal com um comando. A forma mais rápida de testar a API.

Integrando com Cursor, Lovable, v0 ou outra IA?

Copie o prompt de integração e cole direto no seu assistente de IA - ele saberá exatamente como usar a API.

Pré-requisitos

curl instalado (padrão em macOS e Linux)
Uma API Key em app.cpfhub.io

Consulta básica

bash

curl -X GET "https://api.cpfhub.io/cpf/12345678909" \
  -H "x-api-key: cpfh_sua_api_key_aqui"

Resposta

JSON

{
  "data": {
    "cpf": "12345678909",
    "name": "Fulano de Tal",
    "nameUpper": "FULANO DE TAL",
    "gender": "M",
    "birthDate": "15/06/1990",
    "day": 15,
    "month": 6,
    "year": 1990
  }
}

Com formatação via jq

bash

curl -s "https://api.cpfhub.io/cpf/12345678909" \
  -H "x-api-key: $CPFHUB_API_KEY" | jq '.data.name'

Usando variável de ambiente

bash

export CPFHUB_API_KEY=cpfh_sua_api_key_aqui

curl -s "https://api.cpfhub.io/cpf/12345678909" \
  -H "x-api-key: $CPFHUB_API_KEY"

Verificar status HTTP

bash

curl -o /dev/null -s -w "%{http_code}\n" \
  "https://api.cpfhub.io/cpf/12345678909" \
  -H "x-api-key: $CPFHUB_API_KEY"
# 200

Erros comuns

bash

# CPF não encontrado → 404
curl -s "https://api.cpfhub.io/cpf/00000000000" \
  -H "x-api-key: $CPFHUB_API_KEY"
# {"error":{"code":"CPF_NOT_FOUND","message":"CPF não encontrado"}}

# API Key inválida → 401
curl -s "https://api.cpfhub.io/cpf/12345678909" \
  -H "x-api-key: chave_invalida"
# {"error":{"code":"UNAUTHORIZED","message":"API Key inválida"}}

Campos retornados

Campo	Tipo	Exemplo
`cpf`	string	`"12345678909"`
`name`	string	`"Fulano de Tal"`
`nameUpper`	string	`"FULANO DE TAL"`
`gender`	`"M"` \| `"F"`	`"M"`
`birthDate`	string	`"15/06/1990"`
`day`	number	`15`
`month`	number	`6`
`year`	number	`1990`

Tratamento de erros

HTTP	`error.code`	Descrição
404	`CPF_NOT_FOUND`	CPF não consta na base
422	`INVALID_CPF_DIGITS`	Dígitos verificadores inválidos
429	`RATE_LIMIT_EXCEEDED`	Muitas requisições
401	`UNAUTHORIZED`	API Key inválida ou ausente

Links

Atualizado em 17 de maio de 2026