Verificación de Edad
Verificación de edad por CPF
para la ECA Digital.
La ECA Digital es la ley brasileña de protección digital de niños y adolescentes. Consulta un CPF (el número de identificación fiscal de personas físicas en Brasil) y recibe la fecha de nacimiento del titular en JSON. Tu sistema calcula la edad y aplica el corte que pida tu regla: 18+, 16+ o 21+. Sin selfie, sin subir documentos. 50 créditos gratis al mes para probar.
CPFHub.io entrega el dato. El cumplimiento de la ECA Digital sigue siendo responsabilidad de la plataforma.
Lo que recibes
El dato que pide la ley, con tu regla.
La ECA Digital exige una verificación de edad confiable, y la autodeclaración por sí sola no basta. La fecha de nacimiento del CPF es el punto de partida.
La fecha de nacimiento
En DD/MM/AAAA y también separada en día, mes y año. Calcular la edad pasa a ser una comparación de números.
El nombre del titular
Útil para confirmar que el CPF ingresado pertenece de verdad a quien se registra, comparándolo con el nombre escrito.
El corte es tuyo
La API no devuelve un rango de edad ya calculado. Tú defines 18+, 16+ o 21+ y cambias la regla sin depender de nosotros.
Sin selfie y sin documento
Es una consulta de registro. No hay cámara, OCR ni subida de archivos, así que el registro no gana un paso extra.
Cómo funciona
Tres pasos, un cálculo de edad.
La consulta devuelve la fecha de nacimiento. La edad se calcula en tu backend, con la regla que necesite tu producto.
01
Consulta el CPF informado
Una solicitud GET /cpf/{cpf} con el header x-api-key, en el registro, en el checkout o en el primer acceso. El CPF va en la URL, con o sin formato.
02
Lee la fecha de nacimiento
El JSON trae birthDate en DD/MM/AAAA y también day, month y year por separado. Sin parsear texto para saber el año.
03
Aplica tu regla
Tu backend calcula la edad y decide: permitir el acceso, pedir consentimiento parental o activar otro método de verificación de edad. La decisión es de la plataforma.
const res = await fetch(`https://api.cpfhub.io/cpf/${cpf}`, {
headers: { 'x-api-key': process.env.CPFHUB_API_KEY },
})
if (res.status === 404) {
// CPF sin registro: usa otro método de verificación de edad
}
const { data } = await res.json()
const { day, month, year } = data
const hoje = new Date()
let idade = hoje.getFullYear() - year
if (hoje.getMonth() + 1 < month || (hoje.getMonth() + 1 === month && hoje.getDate() < day)) {
idade -= 1
}
const maiorDeIdade = idade >= 18Dónde usarlo
Donde la edad cambia el acceso.
Del registro al checkout, la consulta entra en el flujo que ya tienes, sin un paso extra para el usuario.
Límites
Lo que cubre la consulta, y lo que no cubre.
Un CPF no encontrado no consume créditos. Para quien no tiene CPF o no aparece en la base de datos, el flujo alternativo es de tu plataforma.
| Situación | Qué ocurre |
|---|---|
| CPF encontrado | HTTP 200 con birthDate. Consume 1 crédito. |
| CPF válido sin registro | HTTP 404. Sin fecha de nacimiento y sin costo. Usa otro método de verificación de edad. |
| CPF con formato o dígito incorrecto | HTTP 400 o 422. Sin costo. Pide a la persona que lo corrija. |
| Usuario sin CPF | Fuera de la consulta. La plataforma define otro método de verificación de edad. |
| Créditos agotados en el plan Gratis | HTTP 403. La API se detiene hasta el próximo ciclo o hasta que cambies de plan. |
CPFHub.io no hace verificación biométrica ni lee documentos. Tampoco bloquea a nadie: devuelve la fecha de nacimiento y la plataforma decide.
Planes
1 crédito por verificación. Empieza en el plan Gratis.
Cada CPF encontrado consume 1 crédito del saldo del plan. En el plan Gratis, la API se detiene cuando se agotan los créditos. El excedente existe solo en los planes de pago. Todos los precios están en reales brasileños (BRL).
Gratis
R$ 0
50 créditos al mes, sin tarjeta
SLA 95%
Pro
Desde R$ 19
100 a 10.000 créditos/mes, excedente de R$ 0,19 a R$ 0,10
SLA 99%
Enterprise
A consultar
Más de 10.000 créditos al mes
SLA 99,9%
Intégrala en cualquier lenguaje
API REST con especificación OpenAPI y ejemplos listos, tan simple que tu agente de IA puede integrarla por sí solo.
curl -X GET \
'https://api.cpfhub.io/cpf/12345678909' \
-H 'x-api-key: YOUR_API_KEY'{
"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
}
}50 créditos gratis al mes, sin tarjeta.
FAQ
Preguntas frecuentes
¿Se puede verificar la edad de un usuario solo con el CPF?
Sí, para quien informa un CPF con registro. La Consulta Simple (GET /cpf/{cpf}) devuelve nombre, género y fecha de nacimiento (birthDate en formato DD/MM/AAAA, además de day, month y year). Tu sistema calcula la edad y aplica el corte que exige la regla. CPFHub.io no devuelve la edad calculada y no bloquea al usuario.
¿La API calcula la edad o devuelve una franja de edad?
No. La respuesta trae la fecha de nacimiento y tú haces la cuenta en tu backend, comparando con la fecha de hoy. El campo year viene separado para facilitarlo. Así el corte (18+, 16+, 21+) y la regla de negocio quedan bajo tu control.
¿La autodeclaración de edad todavía basta según el ECA Digital?
El ECA Digital (Ley 15.211/2025) pide mecanismos confiables de verificación de edad, y la simple autodeclaración no es el camino. Consultar el CPF y revisar la fecha de nacimiento aporta un dato de registro para esa verificación. La elección del método y el cumplimiento final son responsabilidad de la plataforma.
¿La consulta de CPF reemplaza el cumplimiento del ECA Digital?
No. La ley exige verificar la edad, y CPFHub.io entrega la fecha de nacimiento para que tu sistema decida. Las políticas, los flujos, el consentimiento parental y las demás obligaciones siguen siendo de la plataforma. Ante dudas, consulta a tu área legal y las orientaciones de la ANPD, la autoridad brasileña de protección de datos.
¿Qué pasa si el CPF no se encuentra?
La API responde 404 y no consume crédito. Sin registro no hay fecha de nacimiento, así que tu sistema necesita un camino alternativo para ese usuario, como otro método de verificación o una revisión manual. Un CPF con formato o dígito verificador incorrecto devuelve 400 o 422, también sin costo.
¿Sirve para quien no tiene CPF?
No directamente. La consulta depende de que el usuario informe un CPF. Quien no tiene CPF, como algunos extranjeros, necesita otro método de verificación, definido por la plataforma.
¿CPFHub.io usa selfie, biometría o lectura de documentos?
No. La Consulta Simple es una consulta de registro: nada de cámara, selfie, OCR ni subida de documentos. No es una verificación de identidad biométrica.
¿Cuánto cuesta verificar la edad?
La consulta con CPF encontrado cuesta 1 crédito. El plan Gratis incluye 50 créditos por mes, sin tarjeta, y la API se detiene cuando se agotan los créditos. El plan Pro empieza en R$ 19 por mes con 100 créditos y tiene niveles de hasta 10.000, con excedente de R$ 0,19 a R$ 0,10 por consulta. Un CPF no encontrado no se cobra.
¿Puedo verificar la edad de una base de usuarios que ya tengo?
Sí. La Consulta por Lote (POST /cpf/bulk) acepta hasta 10.000 CPF por job asíncrono y devuelve los mismos campos. Solo los CPF encontrados consumen crédito.
¿Cuándo empieza la fiscalización del ECA Digital?
La ley está en vigor desde el 17 de marzo de 2026 y fue reglamentada por el Decreto 12.880/2026. Según el cronograma de implementación, la fiscalización con aplicación de multas empieza en enero de 2027. Confirma plazos y exigencias con la ANPD y con tu área legal.
¿Todavía tienes dudas?
ContáctanosVerifica la edad
en el registro.
50 créditos gratis al mes, sin tarjeta. La clave aparece en el dashboard al instante.
Acceso inmediato a tu clave de API y a la documentación.