CPFHub.io

Go

Consulte CPF com net/http da biblioteca padrão. Sem dependências externas.

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.

Abrir no Cursor

Pré-requisitos

Exemplo

Go
package main

import (
	"encoding/json"
	"fmt"
	"net/http"
	"os"
)

type Response struct {
	Data struct {
		Name      string `json:"name"`
		BirthDate string `json:"birthDate"`
		Gender    string `json:"gender"`
	} `json:"data"`
}

func main() {
	cpf    := "12345678909"
	apiKey := os.Getenv("CPFHUB_API_KEY")

	req, err := http.NewRequest("GET", "https://api.cpfhub.io/cpf/"+cpf, nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("x-api-key", apiKey)

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	if resp.StatusCode != 200 {
		panic(fmt.Sprintf("API error: %d", resp.StatusCode))
	}

	var result Response
	json.NewDecoder(resp.Body).Decode(&result)

	fmt.Println(result.Data.Name)      // "Fulano de Tal"
	fmt.Println(result.Data.BirthDate) // "15/06/1990"
	fmt.Println(result.Data.Gender)    // "M"
}

Campos retornados

Campo JSONTipo GoExemplo
namestring"Fulano de Tal"
nameUpperstring"FULANO DE TAL"
genderstring"M"
birthDatestring"15/06/1990"
dayint15
monthint6
yearint1990

Tratamento de erros

HTTPerror.codeDescrição
404CPF_NOT_FOUNDCPF não consta na base
422INVALID_CPF_DIGITSDígitos verificadores inválidos
429RATE_LIMIT_EXCEEDEDMuitas requisições
401UNAUTHORIZEDAPI Key inválida ou ausente

Links


Atualizado em 17 de maio de 2026