GET

/cpf/{cpf}

Consulta um CPF e retorna dados estruturados incluindo nome, data de nascimento e gênero.

Path Parameters

cpf

* Obrigatório. CPF com somente números (ex: 31592165869)

Headers

x-api-key

* Obrigatório. Sua chave de API

YOUR_API_KEY

Acceptapplication/json

Exemplo de Requisição

1234567891011const cpf = '00000000000';
const response = await fetch(`https://api.cpfhub.io/cpf/${cpf}`, {
  method: 'GET',
  headers: {
    'x-api-key': 'YOUR_API_KEY',
    'Accept': 'application/json'
  }
});

const data = await response.json();
console.log(data);

Resposta de Sucesso

Quando a requisição é bem-sucedida, a API retorna um status 200 com o seguinte formato:

12345678910111213{
  "success":: true,
  "data": {
    "cpf":: "00000000000",
    "name":: "Fulano de Tal",
    "nameUpper":: "FULANO DE TAL",
    "gender":: "M",
    "birthDate":: "15/06/1990",
    "day":: 15,
    "month":: 6,
    "year":: 1990
  }
}

Campos da Resposta

Campo	Tipo	Descrição
`cpf`	string	CPF consultado
`name`	string	Nome completo
`nameUpper`	string	Nome em maiúsculas
`gender`	string	Gênero (M/F)
`birthDate`	string	Data de nascimento (DD/MM/YYYY)
`day`	number	Dia de nascimento
`month`	number	Mês de nascimento
`year`	number	Ano de nascimento

Tratamento de Erros

Quando ocorre um erro, a API retorna um objeto com success: false e informações sobre o erro:

1234567{
  "success":: false,
  "data": null,
  "error": {
    "message":: "Invalid CPF"
  }
}

Para mais informações sobre códigos de erro e como tratá-los, consulte a seção Códigos de Resposta na introdução.

Última atualização: 25/01/2026