Node.js

Consulte CPF com uma chamada HTTP. Node.js 18+ tem fetch nativo - sem dependências.

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

Node.js 18+ (fetch nativo disponível)
Uma API Key em app.cpfhub.io

Exemplo

const CPF = '12345678909'
const API_KEY = process.env.CPFHUB_API_KEY!

const res = await fetch(`https://api.cpfhub.io/cpf/${CPF}`, {
headers: { 'x-api-key': API_KEY },
})

if (!res.ok) {
const err = await res.json()
throw new Error(err.error.code)
}

const { data } = await res.json()

console.log(data.name)       // "Fulano de Tal"
console.log(data.birthDate)  // "15/06/1990"
console.log(data.gender)     // "M"

✦

CPF com ou sem formatação

A API aceita CPF com ou sem pontuação: "12345678909" e "123.456.789-09" são equivalentes.

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 - aguarde
401	`UNAUTHORIZED`	API Key inválida ou ausente

Links

Atualizado em 17 de maio de 2026