Verificação de idade
Verificação de idade por CPF
para a ECA Digital.
Consulte o CPF e receba a data de nascimento do titular em JSON. O seu sistema calcula a idade e aplica o corte da sua plataforma (18+, 16+ ou 21+), sem selfie e sem upload de documento.
50 créditos grátis por mês, sem cartão de crédito.
O que você recebe
A data de nascimento, na sua regra.
A ECA Digital pede aferição de idade confiável, e a autodeclaração sozinha não basta. A data de nascimento do CPF, conferida com o nome do titular, é parte desse fluxo.
A data de nascimento
Em DD/MM/AAAA e também separada em dia, mês e ano. Calcular a idade vira uma conta simples, sem tratar texto.
birthDatedaymonthyearO nome do titular
Compare com o nome digitado no cadastro para confirmar que o CPF pertence a quem está se cadastrando.
namenameUpperO corte é seu
A API não devolve faixa etária pronta. Você define 18+, 16+ ou 21+ e muda a regra quando quiser.
Sem selfie e sem documento
É uma consulta cadastral. Não há câmera, OCR nem upload de arquivo, então o cadastro não ganha uma etapa a mais.
Como funciona
Três passos, uma conta de idade.
A consulta devolve a data de nascimento. A idade é calculada no seu backend, com a regra que o seu produto precisa.
- 01
Consulte o CPF informado
Uma requisição GET /cpf/{cpf} com o header x-api-key, no cadastro, no checkout ou no primeiro acesso. O CPF vai na URL, com ou sem máscara.
- 02
Leia a data de nascimento
O JSON traz birthDate em DD/MM/AAAA e também day, month e year separados. Nada de parser de string para saber o ano.
- 03
Aplique a sua regra
O seu backend confere o nome, calcula a idade e decide: liberar, pedir consentimento parental ou acionar outro método de aferição. A decisão é da plataforma.
async function verificarIdade(cpf, nomeDigitado) {
const res = await fetch(`https://api.cpfhub.io/cpf/${cpf}`, {
headers: { 'x-api-key': process.env.CPFHUB_API_KEY },
})
// CPF sem registro: use outro método de aferição
if (res.status === 404) return { status: 'sem_registro' }
// Outros erros (400, 422, 403, 429): trate pelo código HTTP
if (!res.ok) return { status: 'erro', http: res.status }
const { data } = await res.json()
// Titularidade: o nome digitado deve bater com o do CPF
const mesmoNome = nomeDigitado.trim().toLocaleUpperCase('pt-BR') === data.nameUpper
const hoje = new Date()
let idade = hoje.getFullYear() - data.year
const aindaNaoFezAniversario =
hoje.getMonth() + 1 < data.month ||
(hoje.getMonth() + 1 === data.month && hoje.getDate() < data.day)
if (aindaNaoFezAniversario) idade -= 1
return { status: 'ok', mesmoNome, idade, maiorDeIdade: idade >= 18 }
}Onde usar
Onde a idade muda o acesso.
Do cadastro ao checkout, a consulta entra no fluxo que você já tem, sem etapa extra para o usuário.
Limites
O que a consulta cobre e o que não cobre.
CPF não encontrado não cobra crédito. Para quem não tem CPF ou não aparece na base, o fluxo alternativo é da sua plataforma.
- CPF encontradoHTTP 200 com birthDate. Consome 1 crédito.
- CPF válido sem registroHTTP 404. Sem data de nascimento e sem custo. Use outro método de aferição.
- CPF com formato ou dígito incorretoHTTP 400 ou 422. Sem custo. Peça para a pessoa corrigir.
- Usuário sem CPFFora da consulta. A plataforma define outro método de aferição.
- Créditos esgotados no plano GrátisHTTP 403. A API para até o próximo ciclo ou até você migrar de plano.
A CPFHub.io entrega a data de nascimento e apoia a sua conformidade. Não faz verificação biométrica, não lê documento e não bloqueia usuários. A decisão e a conformidade com a ECA Digital continuam sendo da plataforma.
Planos
1 crédito por verificação. Comece no Grátis.
Cada CPF encontrado consome 1 crédito do saldo do plano. No Grátis, a API para quando os créditos acabam. O excedente existe apenas nos planos pagos.
Grátis
R$ 0
50 créditos por mês, sem cartão
SLA 95%
Pro
A partir de R$ 19
100 a 10.000 créditos/mês, excedente de R$ 0,19 a R$ 0,10
SLA 99%
Corporativo
Sob consulta
Acima de 10.000 créditos por mês
SLA 99,9%
Perguntas frequentes
É possível verificar a idade de um usuário só com o CPF?
Sim, para quem informa um CPF com cadastro. A Consulta Simples (GET /cpf/{cpf}) devolve nome, gênero e data de nascimento (birthDate em DD/MM/AAAA, além de day, month e year). O seu sistema calcula a idade e aplica o corte que a regra exige. A CPFHub.io não devolve a idade pronta e não bloqueia o usuário.
A API calcula a idade ou devolve uma faixa etária?
Não. A resposta traz a data de nascimento e você faz a conta no seu backend, comparando com a data de hoje. O campo year vem separado para facilitar. Assim o corte (18+, 16+, 21+) e a regra de negócio ficam sob o seu controle.
A autodeclaração de idade ainda basta pela ECA Digital?
A ECA Digital (Lei 15.211/2025) pede mecanismos confiáveis de aferição de idade, e a simples autodeclaração não é o caminho. A data de nascimento do CPF, conferida com o nome do titular, é parte de um fluxo de aferição. A escolha do método e a conformidade final são responsabilidade da plataforma.
A consulta de CPF substitui a conformidade com a ECA Digital?
Não. A lei exige aferição de idade, e a CPFHub.io entrega a data de nascimento para o seu sistema decidir. Políticas, fluxos, consentimento parental e as demais obrigações continuam sendo da plataforma. Em caso de dúvida, consulte o seu jurídico e as orientações da ANPD.
O que acontece se o CPF não for encontrado?
A API responde 404 e não consome crédito. Sem registro não há data de nascimento, então o seu sistema precisa de um caminho alternativo para esse usuário, como outra forma de aferição ou revisão manual. CPF com formato ou dígito verificador incorreto retorna 400 ou 422, também sem custo.
Serve para quem não tem CPF?
Não diretamente. A consulta depende de o usuário informar um CPF. Quem não tem CPF, como alguns estrangeiros, precisa de outro método de aferição, definido pela plataforma.
A CPFHub.io usa selfie, biometria ou leitura de documento?
Não. A Consulta Simples é uma consulta cadastral: nada de câmera, selfie, OCR ou upload de documento. Ela não é uma verificação de identidade biométrica.
Quanto custa verificar a idade?
A consulta com CPF encontrado custa 1 crédito. O plano Grátis inclui 50 créditos por mês, sem cartão, e a API para quando os créditos acabam. O Pro começa em R$ 19 por mês com 100 créditos e tem faixas de até 10.000, com excedente de R$ 0,19 a R$ 0,10 por consulta. CPF não encontrado não cobra.
Posso conferir a idade de uma base de usuários que já tenho?
Sim. A Consulta em Lote (POST /cpf/bulk) aceita até 10.000 CPFs por lote, com processamento assíncrono, e devolve os mesmos campos. Só os CPFs encontrados consomem crédito.
Quando começa a fiscalização da ECA Digital?
A lei está em vigor desde 17 de março de 2026 e foi regulamentada pelo Decreto 12.880/2026. Pelo cronograma de implementação, a fiscalização com aplicação de multas começa em janeiro de 2027. Confirme prazos e exigências com a ANPD e com o seu jurídico.
Verifique a idade
no cadastro.
- 50 créditos grátis por mês
- Sem cartão de crédito
- Atendimento 24h no WhatsApp