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

1const cpf = '00000000000';2const response = await fetch(`https://api.cpfhub.io/cpf/${cpf}`, {3  method: 'GET',4  headers: {5    'x-api-key': 'YOUR_API_KEY',6    'Accept': 'application/json'7  }8});910const data = await response.json();11console.log(data);

Resposta de sucesso

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

1{2  "success": true,3  "data": {4    "cpf": "00000000000",5    "name": "Fulano de Tal",6    "nameUpper": "FULANO DE TAL",7    "gender": "M",8    "birthDate": "15/06/1990",9    "day": 15,10    "month": 6,11    "year": 199012  }13}

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:

1{2  "success": false,3  "data": null,4  "error": {5    "message": "Invalid CPF"6  }7}

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

CPFs não encontrados na base de dados não consomem crédito. Apenas requisições que retornam dados são contabilizadas no seu plano.

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