CPFHub.io logo

CPFHub.io

Brazilian CPF lookup API with real-time Receita Federal

Free: 50 credits/month, no card. PRO from R$19/moFreemium

CPFHub.io website

About

CPFHub.io is the developer-first API for verifying Brazilian CPFs (Cadastro de Pessoas Físicas). One API key and one credit balance cover three lookups. Simple lookup: GET /cpf/{cpf} returns the full name, gender and birth date tied to a CPF, typically in about 150 ms. Use it to pre-fill signup forms, confirm that a name matches a CPF, or compute age at checkout. It costs 1 credit, charged only when the CPF is found. Real-time Receita Federal lookup: POST /cpf/realtime takes the CPF plus birth date and queries the official source at request time. It returns the situação cadastral (regular, suspended, pending, cancelled, null, or deceased holder) and the death year. Typical response time is about 1 second, and it costs 1.5 credits on HTTP 200 only. A mismatched birth date returns 422 and is not charged. Bulk: POST /cpf/bulk validates up to 10,000 CPFs per async job. Built for how teams ship today, CPFHub.io offers a public OpenAPI spec, llms.txt, code examples for every major language, and a remote MCP server (https://api.cpfhub.io/mcp) so Claude, Cursor and other agents can look up CPFs natively. Response times are typical values, not an SLA. More than 6,000 companies use CPFHub.io, and it has verified over 30 million CPFs. Start free with 50 credits per month, no credit card.

Features

  • Simple CPF lookup: name, gender, birth date (~150 ms typical, 1 credit)
  • Real-time Receita Federal lookup: situação cadastral and death year (~1 s typical, 1.5 credits)
  • Bulk lookup: up to 10,000 CPFs per async job, CSV export
  • Remote MCP server for AI agents: lookup_cpf, lookup_cpf_realtime, get_quota_info
  • Public OpenAPI 3 spec + llms.txt
  • Simple auth: x-api-key header
  • Official Python SDK (pip install cpfhub) + copy-paste examples
  • Quota endpoint GET /quota and public status page