api DNI/RUC Gateway
login Acceso Admin
verified Servidor desplegado: https://gateway.dni.ruc.lass.pe

La API más rápida y confiable para consultas de RENIEC y SUNAT en tiempo real.

Gateway DNI & RUC proporciona acceso instantáneo con resiliencia en cascada multiproveedor y almacenamiento en caché inteligente. Diseñado para desarrolladores y empresas.

bolt Probar en Vivo (Playground) code Ver Ejemplos de Código

Arquitectura de Resiliencia en Cascada

Cómo se garantiza el 99.9% de éxito en cada consulta

bolt

1. Caché DB Local

Respuesta instantánea (<10ms) si el DNI o RUC ya fue consultado. Ahorra créditos externos.

looks_one

2. apis.net.pe

Fuente primaria oficial. Máxima precisión y estructura de datos completa para RENIEC y SUNAT.

looks_two

3. apiperu.dev

Primer respaldo automático en milisegundos si la fuente primaria falla o excede cuotas.

looks_3

4. peruapi.com

Plan C de contingencia. Garantiza que tu aplicación jamás se quede sin respuesta.

Probar API en Vivo

Ejecuta una consulta real para verificar la respuesta y latencia.

badge
key
JSON RESPONSE
200 OK 
// Haz clic en "Ejecutar Consulta" para probar el Gateway en vivo.
{
  "status": "ready",
  "endpoint": "https://gateway.dni.ruc.lass.pe/api/..."
}
Gateway DNI/RUC timer Latency: 0ms

Guía de Integración Rápida

Copia y pega el código de integración directo en tu proyecto.


                

            

        


        
        

            

                
Especificación de Endpoints

                
Estructura de las solicitudes HTTP disponibles

            


            

                

                    

                        
                            

                                Método
                                Endpoint
                                Descripción
                                Respuesta
                            

                        
                        
                            

                                GET
                                /api/dni/{numero}
                                Consulta de DNI (RENIEC). Retorna nombres y apellidos completos.
                                200 OK JSON
                            

                            

                                GET
                                /api/ruc/{numero}
                                Consulta de RUC (SUNAT). Retorna razón social, estado, condición, dirección y ubigeo.
                                200 OK JSON
                            

                            

                                GET
                                /api/health
                                Verifica si el Gateway está operativo y tu API Key es válida.
                                200 OK JSON
                            

                        
                    

                

            


            
            

                
Códigos de Estado HTTP

                

                    

                        
                            

                                Código
                                Estado
                                Descripción
                            

                        
                        
                            

                                200 OK
                                Éxito
                                Documento encontrado y retornado correctamente.
                            

                            

                                401 Unauthorized
                                Falta API Key
                                Falta la cabecera X-API-KEY en la solicitud.
                            

                            

                                403 Forbidden
                                API Key Inválida
                                La API Key no existe o ha sido desactivada.
                            

                            

                                404 Not Found
                                No Encontrado
                                El número de DNI o RUC no existe en las fuentes públicas.
                            

                            

                                429 Too Many Requests
                                Rate Limit Excedido
                                Superaste el límite máximo de 60 peticiones por minuto.