API de DNI
El nombre de un DNI, con la fuente de la que salió
Para registrar pacientes, clientes o trabajadores sin tipear su nombre. Primero se busca en el padrón de SUNAT; si no está y contrataste la consulta externa, en un proveedor externo. La respuesta dice de cuál salió.
curl https://acredita.stackealabs.com/api/v1/dni/99999999 \
-H "Authorization: Bearer $NEXOID_TOKEN"{
"success": true,
"data": {
"dni": "99999999",
"nombre_completo": "PEREZ GOMEZ, JUAN DE EJEMPLO",
"apellido_paterno": "PEREZ",
"apellido_materno": "GOMEZ",
"nombres": "JUAN DE EJEMPLO",
"confianza_division": "alta",
"ruc": "10999999994",
"estado_ruc": "ACTIVO"
},
"meta": { "origen": "padron_reducido_sunat", "fecha_dato": "…" }
}Endpoints
GET /api/v1/dni/{dni}
El nombre de un DNI · Crecimiento y Empresa, por contrato
POST /api/v1/dni/batch
Hasta 100 DNI por petición, solo del padrón · Crecimiento y Empresa, por contrato
🪪 Por contrato, no en autoservicio. Antes de la primera consulta firmamos el anexo de tratamiento de datos: para qué usa tu sistema el DNI y con qué base legal. Sin él, la consulta responde 403 finalidad_no_declarada. La Ley 29733 y su Reglamento de 2024 (D.S. 016-2024-JUS) lo piden así, y si las reglas cambian, te lo avisamos con 30 días de antelación.
Qué devuelve
| Campo | Qué es | Presente en |
|---|---|---|
| dni | El DNI consultado | siempre |
| nombre_completo | El nombre, como lo publica la fuente | siempre |
| apellido_paterno · apellido_materno · nombres | El nombre en tres partes | siempre |
| confianza_division | Cuánto fiarse de esa división: el padrón no la trae, la hacemos nosotros | siempre |
| ruc · estado_ruc | Su RUC 10 y su estado, cuando el nombre sale del padrón | solo del padrón |
| meta.origen · meta.fecha_dato | De qué fuente sale el nombre y de qué fecha es | siempre |
Preguntas frecuentes
¿Cuántos DNI encuentra?
Del padrón de SUNAT, los de quienes tienen RUC: entre 4 y 7 de cada 10 adultos, según la edad, y muy pocos menores. Para el resto está la consulta externa, si la contratas. Un DNI que no está en ninguna fuente responde 404 y no se cobra.
¿De dónde sale el nombre?
Del padrón reducido del RUC que SUNAT publica cada día: un RUC que empieza en 10 lleva el DNI dentro. Si no está y tu contrato incluye la consulta externa, de un proveedor externo: quién es, está en la política de privacidad. Lo que llega de él vive 48 horas en memoria y nunca se escribe en disco.
¿Qué hace falta para contratarlo?
Un plan Crecimiento o Empresa y el anexo firmado, con la finalidad —registrar pacientes, emitir boletas, validar a un cliente— y la base legal. Escríbenos por WhatsApp y te lo enviamos.
¿Puedo buscar una persona por su nombre?
No. Se consulta un documento que ya tienes; no hay búsqueda por nombre, ni listas, ni exportaciones de personas. Es una regla del servicio, también para los clientes con contrato.
¿Y los RUC que empiezan en 10, 15 o 17?
Son personas naturales, y su nombre es un dato de identidad: reciben el mismo trato que un DNI, también en la API de RUC.
¿Queda registro de cada consulta?
Sí, antes de responder: quién consultó, cuándo y desde qué token. El DNI se guarda como una huella cifrada y sus tres últimos dígitos, nunca en claro. Es lo que permite responder a una persona que pregunta quién vio sus datos.