PHP

Consulte CPF com cURL nativo do PHP. Sem Composer, sem pacotes extras.

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

PHP 7.4+ com extensão cURL habilitada
Uma API Key em app.cpfhub.io

Exemplo

PHP

<?php

$cpf    = '12345678909';
$apiKey = getenv('CPFHUB_API_KEY');

$ch = curl_init("https://api.cpfhub.io/cpf/{$cpf}");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ["x-api-key: {$apiKey}"],
]);

$body = json_decode(curl_exec($ch), true);
$code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($code !== 200) {
    throw new RuntimeException($body['error']['code']);
}

$data = $body['data'];
echo $data['name'] . PHP_EOL;       // "Fulano de Tal"
echo $data['birthDate'] . PHP_EOL;  // "15/06/1990"
echo $data['gender'] . PHP_EOL;     // "M"

Com file_get_contents

PHP

<?php

$cpf    = '12345678909';
$apiKey = getenv('CPFHUB_API_KEY');

$context = stream_context_create([
    'http' => [
        'header' => "x-api-key: {$apiKey}\r\n",
    ],
]);

$body = json_decode(
    file_get_contents("https://api.cpfhub.io/cpf/{$cpf}", false, $context),
    true
);

echo $body['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`	int	`15`
`month`	int	`6`
`year`	int	`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