Elixir

Consulte CPF em Elixir com Req (moderno) ou HTTPoison.

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

Elixir 1.14+ / OTP 25+
Uma API Key em app.cpfhub.io

Dependências

Adicione ao mix.exs:

defp deps do
[
  {:req, "~> 0.5"},
  {:jason, "~> 1.4"}
]
end

bash

mix deps.get

Exemplo

api_key = System.fetch_env!("CPFHUB_API_KEY")
cpf     = "12345678909"

res  = Req.get!("https://api.cpfhub.io/cpf/#{cpf}", headers: [{"x-api-key", api_key}])
data = res.body["data"]

IO.puts(data["name"])       # "Fulano de Tal"
IO.puts(data["birthDate"])  # "15/06/1990"
IO.puts(data["gender"])     # "M"

Campos retornados

Chave	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