API RENIEC: Consulta DNI Gratis vía API en Perú

Si estás construyendo un sistema que necesita validar identidades en Perú, tarde o temprano vas a buscar una API RENIEC. La realidad es que el RENIEC no ofrece una API pública gratuita para terceros, pero existen alternativas legales que consumen datos públicos y los exponen vía REST.

En esta guía resolvemos las dudas más frecuentes de los desarrolladores peruanos: ¿hay una API oficial de RENIEC? ¿Es legal? ¿Cuáles funcionan? ¿Cómo se integra una API de consulta DNI con un ejemplo real?

¿Existe una API oficial de RENIEC?

RENIEC sí ofrece servicios de validación digital, pero solo para entidades públicas o privadas autorizadas mediante convenio. Estos servicios incluyen el "Servicio de Validación de Identidad" y el "Servicio de Verificación Biométrica", que requieren un trámite formal, certificación digital y, en muchos casos, justificar el caso de uso ante la entidad.

Para un desarrollador individual, una startup pequeña o un proyecto que recién arranca, este camino es lento y costoso. Por eso surgió todo un ecosistema de proveedores que consumen los datos públicos disponibles bajo la Ley de Transparencia (Ley 27806) y los exponen vía API.

API RENIEC gratis: ejemplo con Scrall

Para quienes necesitan empezar sin pagar, Scrall ofrece una API gratuita que permite consultar datos básicos de un DNI con una simple petición HTTP. Es ideal para prototipos, pruebas de concepto, o validaciones esporádicas.

Aquí tienes el ejemplo funcional con curl:

curl -X POST https://api.scrall.net/v1/reniec/basico \
  -H "Content-Type: application/json" \
  -d '{"dni": "00000001"}'

La respuesta típica devuelve los nombres y apellidos en formato JSON. Es perfecto para ese momento "lo voy a probar antes de comprometerme" o cuando solo necesitas mostrar el nombre asociado a un DNI ingresado en un formulario.

⚡ Tip: Para entornos de producción que requieran alto volumen, SLA, respaldo legal documentado o datos extendidos (RUC asociado, padrón electoral, foto), conviene migrar a una API empresarial con contrato.

¿Qué obtienes con la API gratuita de Scrall?

• Nombres y apellidos asociados al DNI.
• Respuesta en JSON lista para consumir.
• Sin autenticación compleja para empezar.
• Sirve perfecto para autocompletar formularios de registro.

Ejemplo en JavaScript (Node.js / fetch)

const res = await fetch('https://api.scrall.net/v1/reniec/basico', {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({ dni: '00000001' })
});
const data = await res.json();
console.log(data); // { nombres, apellido_paterno, apellido_materno, ... }

Ejemplo en Python (requests)

import requests
r = requests.post(
    'https://api.scrall.net/v1/reniec/basico',
    json={'dni': '00000001'}
)
print(r.json())

Ejemplo en PHP (cURL)

$ch = curl_init('https://api.scrall.net/v1/reniec/basico');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode(['dni' => '00000001']));
$response = json_decode(curl_exec($ch), true);
print_r($response);

API empresarial de Scrall

Cuando el caso de uso pasa de "validar un nombre" a verificación KYC seria, onboarding regulado, fintech, delivery, recursos humanos, etc., los datos básicos no alcanzan. Necesitas:

• ✅ Datos extendidos: fecha de nacimiento, ubigeo, estado civil, restricciones.
• ✅ Verificación cruzada: DNI ↔ RUC ↔ representantes legales ↔ vehículos.
• ✅ Reportes PDF firmados para respaldo en fiscalizaciones.
• ✅ Webhooks para procesos asíncronos.
• ✅ SLA garantizado con uptime mensurable.
• ✅ Soporte técnico en horario laboral Perú.

El plan empresarial de Scrall está pensado exactamente para eso: integraciones en producción con alto volumen, contratos firmados y endpoints estables que no van a desaparecer mañana.

Casos de uso reales de una API DNI

¿Es legal usar una API de consulta DNI?

Sí, siempre que respetes el marco legal peruano:

• 📜 Ley 29733 — Protección de Datos Personales. Necesitas finalidad legítima.
• 📜 Ley 27806 — Acceso a la Información Pública. Define qué datos son consultables.
• 📜 Decreto Legislativo 1353 — Crea la Autoridad Nacional de Transparencia.

En la práctica esto significa:

• ✓ Sí puedes validar que un DNI existe y corresponde a un nombre.
• ✓ Sí puedes validar datos públicos de RUCs.
• ✗ No puedes almacenar masivamente datos personales sin consentimiento.
• ✗ No puedes revender los datos como base de marketing.

Buenas prácticas de integración

1. Cachea con cabeza

Los datos del padrón cambian con baja frecuencia. Cachear respuestas por 24–72h baja costos y mejora latencia. Nunca caches en cliente, solo en backend con TTL.

2. Maneja errores

La API puede devolver: DNI inexistente, formato inválido, rate limit, error 5xx. Implementa retry con backoff exponencial y un fallback claro al usuario.

3. Logea de manera responsable

Loguea metadata (timestamp, status, latencia) pero no loguees datos personales completos en archivos planos sin cifrar.

4. Usa el ambiente correcto

Tu staging debe pegarle a una API de staging, no a producción. Pide al proveedor un set de DNIs de prueba.

5. Documenta la finalidad

Por si te visita la Autoridad Nacional de Protección de Datos, ten documentado por qué consultas, con qué consentimiento y cuánto tiempo guardas cada dato.

Comparativa rápida

Conclusión

Si lo que necesitas es una API para integrar consulta de DNI en tu sistema, Scrall es la opción: tienen un plan gratuito para empezar y planes empresariales con SLA cuando tu negocio escala. Si en cambio solo necesitas hacer consultas puntuales sin integración técnica — desde tu navegador o desde el celular, con reporte PDF descargable — la web y la app móvil de Consulta Perú resuelven todo con créditos prepagados (paquete inicial desde S/ 1), sin necesidad de programar nada.

Preguntas frecuentes