API Consulta RUC-DNI

Nuestra API REST es la plataforma más completa y estable del mercado para consultar información actualizada de contribuyentes (SUNAT) y ciudadanos (RENIEC) en formato JSON, con integración en minutos.

¿Por qué elegir nuestra API?

Datos Completos

Acceso a información exacta, validada y estructurada desde la SUNAT. Excelente para validar datos.

Respuesta Rápida

Tiempo de respuesta altamente optimizado para consultas casi instantáneas de RUC y DNI.

Seguro y Confiable

Autenticación segura mediante Bearer Token y conexiones HTTPS completamente encriptadas.

Alta Disponibilidad

Infraestructura robusta con disponibilidad 24/7 y un algoritmo de búsqueda en cascada por capas.

Casos de uso principales

Facturación Electrónica: Autocompletado de razón social y dirección fiscal para sistemas ERP y POS.
Onboarding (KYC): Verificación de identidad rápida al registrar nuevos clientes o trabajadores en tu plataforma.
Auditoría y Compliance: Validación del estado del contribuyente (Habido/Activo) en tiempo real antes de efectuar transacciones.

💡 ¿Listo para comenzar?

Obtener Token Gratis

Regístrate en nuestra plataforma y obtén tu token de acceso en segundos.

Visitar página principal

Conoce todos nuestros productos, planes y casos de éxito en el sitio web oficial.

Consulta DNI V3

La versión V3 está enfocada en proveer una estructura avanzada separando nombres y apellidos en atributos independientes. Por el momento solo está disponible para DNI.

POST /api/v3/consultas

Ejemplo de petición (Body):

{
    "token": "TU_TOKEN_SECRETO",
    "dni": "70327732"
}

* Nota: La versión V3 para consulta RUC aún no está disponible.

Formato de Respuesta (separación de nombres):

{
    "api": "sunat",
    "success": true,
    "nombreSoli": "JUAN CARLOS",
    "apePatSoli": "PEREZ",
    "apeMatSoli": "GARCIA"
}

curl -X POST "https://apirucdni.com/api//consultas" \
    -H "Content-Type: application/json" \
    -H "Accept: application/json" \
    -d '{"token":"TU_TOKEN_SECRETO","":""}'

$response = Http::post('https://apirucdni.com/api//consultas', [
        'token' => 'TU_TOKEN_SECRETO',
        '' => ''
    ]);

fetch('https://apirucdni.com/api//consultas', {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json',
        'Accept': 'application/json'
    },
    body: JSON.stringify({ token: 'TU_TOKEN_SECRETO', []: '' })
})

Diccionario de Errores (Troubleshooting)

Nuestra API utiliza códigos de estado HTTP convencionales para indicar el éxito o fracaso de una petición. En caso de error, el cuerpo de la respuesta siempre incluirá un mensaje descriptivo para ayudarte a depurar el problema rápidamente.

400

Bad Request

Hay un error en tu petición. Usualmente significa que el DNI no tiene 8 dígitos o el RUC no tiene 11 dígitos numéricos válidos. En V2 y V3 verifica que estás enviando el JSON correcto.

401

Unauthorized

No enviaste el token de autenticación en los headers, o el token que enviaste ya fue eliminado o expiró.

404

Not Found

La petición es correcta, pero el RUC o DNI que consultaste no existe en las bases de datos de SUNAT/RENIEC.

429

Too Many Requests

Alcanzaste tu límite de peticiones permitidas por minuto o mensual. Debes esperar o adquirir un nuevo plan.

500

Internal Server Error

Problemas del lado del servidor. Ocurre raras veces cuando los sistemas de origen (SUNAT/RENIEC) están en mantenimiento o inestables.

Contenido

API Consulta RUC-DNI

¿Por qué elegir nuestra API?

Datos Completos

Respuesta Rápida

Seguro y Confiable

Alta Disponibilidad

Casos de uso principales

💡 ¿Listo para comenzar?

Obtener Token Gratis

Visitar página principal

Autenticación

Límites de Uso (Rate Limits)

Consulta de RUC

Parámetros de Ruta

Consulta de DNI

Aviso Legal