# API de CPF grátis: 50 créditos/mês sem cartão | CPFHub.io

> Teste a API de consulta de CPF com 50 créditos grátis por mês. Retorna nome, gênero e data de nascimento. Sem cartão. SLA 95% no plano Grátis.

**URL:** https://www.cpfhub.io/api-cpf-gratis

---

# API de CPF grátis para testar de verdade

50 créditos/mês, sem cartão de crédito. Ideal para MVP e integração. Quando passar do Grátis, o Pro começa em R$19/mês.

[Começar grátis](https://app.cpfhub.io/auth/register) [Ver preços](https://www.cpfhub.io/precos) [Ver docs](https://www.cpfhub.io/documentacao/inicio) 

*   O que a API retorna
    
    Nome completo, gênero (M/F) e data de nascimento. Também nameUpper e dia, mês e ano separados.
    
*   Sem throttling por segundo
    
    Limite padrão de 30 requisições por minuto na Consulta Simples (cada lote conta como 1) e 5 na Consulta em Tempo Real, ajustável em planos personalizados. O consumo é controlado pelo pool de créditos do mês. SLA de disponibilidade: 95% no Grátis.
    
*   Sem crédito no Grátis: 403
    
    No Grátis (sem overage), GET /cpf com saldo zero retorna 403 ("Limite de créditos excedido").
    
*   Docs + API key em minutos
    
    Crie a conta, copie a chave em x-api-key e chame GET /cpf/{cpf}. Documentação e exemplos prontos.
    

## Um GET e o JSON volta completo

Header x-api-key. Base https://api.cpfhub.io. Sem versão na URL.

cURLGET /cpf/{cpf}

1

2

3

```bash
curl -X GET \
  'https://api.cpfhub.io/cpf/12345678909' \
  -H 'x-api-key: YOUR_API_KEY'
```

Resposta JSON200 OK

1

2

3

4

5

6

7

8

9

10

11

12

13

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

## Perguntas frequentes

Quantas consultas tem o plano Grátis?

O Grátis inclui 50 créditos por mês. A Consulta Simples com CPF encontrado (HTTP 200) custa 1 crédito e a Consulta em Tempo Real custa 1,5 crédito. CPF não encontrado (404) ou com formato ou dígito verificador incorreto (400/422) não consome crédito. Os créditos não acumulam para o mês seguinte.

Precisa de cartão de crédito?

Não. O plano Grátis não exige cartão. Você cria a conta em app.cpfhub.io, gera a API key e começa a consultar.

O que acontece em 0 créditos?

No Grátis (sem overage), GET /cpf retorna 403 com a mensagem "Limite de créditos excedido". No lote, itens sem saldo são marcados como skipped. Nos planos com overage ativo a consulta continua e o excedente entra no ciclo seguinte. Detalhes em /precos.

O Grátis tem SLA?

Sim. SLA de disponibilidade por plano: Grátis 95%, Pro 99%, Corporativo 99,9%. Consulte /precos. O tempo típico da Consulta Simples é ~150 ms e o da Consulta em Tempo Real é cerca de 1 segundo. São referências típicas, não um SLA. Na Consulta em Lote, o tempo depende de quantos CPFs estão no envio, e cada consulta fica na mesma faixa da Consulta Simples.

Ainda tem dúvidas?

[Entre em contato](https://api.whatsapp.com/send/?phone=551132300861&text=Ol%C3%A1!%20Estou%20testando%20o%20plano%20Gr%C3%A1tis%20da%20CPFHub.io%20e%20gostaria%20de%20tirar%20algumas%20d%C3%BAvidas%20antes%20de%20integrar.&type=phone_number&app_absent=0) 

## Comece no Grátis  
hoje.

50 créditos/mês, sem cartão. API key no dashboard. Quando crescer, o Pro começa em R$19/mês.

[Começar grátis](https://app.cpfhub.io/auth/register) [Ver preços](https://www.cpfhub.io/precos) [Ver docs](https://www.cpfhub.io/documentacao/inicio) 

Acesso imediato à API Key e documentação.