Express

Exponha consultas de CPF como um endpoint REST com Express. Sem dependências além do próprio framework.

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)
Express instalado (npm install express)
Uma API Key em app.cpfhub.io

Exemplo

TypeScript

import express from 'express'

const app = express()
const API_KEY = process.env.CPFHUB_API_KEY!

app.get('/cpf/:cpf', async (req, res) => {
  const apiRes = await fetch(`https://api.cpfhub.io/cpf/${req.params.cpf}`, {
    headers: { 'x-api-key': API_KEY },
  })

  const body = await apiRes.json()

  if (!apiRes.ok) {
    return res.status(apiRes.status).json({ error: body.error })
  }

  res.json({ data: body.data })
})

app.listen(3000, () => console.log('Server running on :3000'))

JavaScript

// JavaScript (CommonJS)
const express = require('express')

const app = express()
const API_KEY = process.env.CPFHUB_API_KEY

app.get('/cpf/:cpf', async (req, res) => {
  const apiRes = await fetch(`https://api.cpfhub.io/cpf/${req.params.cpf}`, {
    headers: { 'x-api-key': API_KEY },
  })

  const body = await apiRes.json()

  if (!apiRes.ok) {
    return res.status(apiRes.status).json({ error: body.error })
  }

  res.json({ data: body.data })
})

app.listen(3000)

Testando

bash

curl http://localhost:3000/cpf/12345678909

Resposta:

JSON

{
  "data": {
    "cpf": "12345678909",
    "name": "Fulano de Tal",
    "gender": "M",
    "birthDate": "15/06/1990"
  }
}

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