Ruby

Consulte CPF com Net::HTTP da biblioteca padrão. Sem gems adicionais.

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

Ruby 2.7+
Uma API Key em app.cpfhub.io

Exemplo

Ruby

require 'net/http'
require 'json'

cpf     = '12345678909'
api_key = ENV.fetch('CPFHUB_API_KEY')

uri = URI("https://api.cpfhub.io/cpf/#{cpf}")
req = Net::HTTP::Get.new(uri)
req['x-api-key'] = api_key

res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) }

raise "#{res.code}: #{res.body}" unless res.is_a?(Net::HTTPSuccess)

data = JSON.parse(res.body)['data']
puts data['name']       # "Fulano de Tal"
puts data['birthDate']  # "15/06/1990"
puts data['gender']     # "M"

Com faraday (opcional)

Ruby

# gem 'faraday'
require 'faraday'
require 'json'

conn = Faraday.new('https://api.cpfhub.io') do |f|
  f.response :raise_error
end

res  = conn.get("/cpf/12345678909", {}, { 'x-api-key' => ENV['CPFHUB_API_KEY'] })
data = JSON.parse(res.body)['data']
puts data['name']

Campos retornados

Campo	Tipo	Exemplo
`cpf`	String	`"12345678909"`
`name`	String	`"Fulano de Tal"`
`nameUpper`	String	`"FULANO DE TAL"`
`gender`	String	`"M"`
`birthDate`	String	`"15/06/1990"`
`day`	Integer	`15`
`month`	Integer	`6`
`year`	Integer	`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