Consulta RUC y DNI del Perú en una sola API
Integra validación de personas y empresas en tu sistema de facturación, ERP o app en minutos. Token Bearer, respuestas JSON limpias e historial completo de cada consulta.
$ curl --request POST --url https://ruc.factornube.com/api/dni \ --header 'Authorization: Bearer TU_TOKEN' \ --data '{"dni": "27427864"}' { "success": true, "data": { "id": "27427864", "nombres": "JOSE PEDRO", "appat": "CASTILLO", "apmat": "TERRONES", "fecnac": "19/10/1969", "ubigeo": "060615", "genero": "M" } }
Todo lo que necesitas para validar en Perú
Datos oficiales, siempre actualizados, en un formato JSON consistente y fácil de integrar desde cualquier lenguaje.
API DNI — RENIEC
Consulta los datos de cualquier persona registrada en RENIEC a partir de su número de DNI. Ideal para validar clientes en tu punto de venta o sistema de facturación.
API RUC — SUNAT
Información tributaria completa de cualquier empresa registrada en SUNAT: perfecta para emitir comprobantes electrónicos sin errores de datos.
API Tipo de Cambio
Tipo de cambio oficial SUNAT del día, listo para tus comprobantes en dólares.
API Consulta CPE
Verifica la validez de comprobantes de pago electrónicos ante SUNAT.
Integra en minutos, en tu lenguaje
Autenticación simple con token Bearer. Copia, pega tu token y listo — sin SDKs obligatorios ni configuraciones complejas.
curl --request POST \ --url https://ruc.factornube.com/api/dni \ --header 'Authorization: Bearer TU_TOKEN' \ --header 'Content-Type: application/json' \ --data '{"dni": "27427864"}'
<?php $ch = curl_init('https://ruc.factornube.com/api/dni'); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_POST => true, CURLOPT_HTTPHEADER => [ 'Authorization: Bearer TU_TOKEN', 'Content-Type: application/json', ], CURLOPT_POSTFIELDS => json_encode(['dni' => '27427864']), ]); $persona = json_decode(curl_exec($ch), true); curl_close($ch);
import requests r = requests.post( 'https://ruc.factornube.com/api/dni', headers={'Authorization': 'Bearer TU_TOKEN'}, json={'dni': '27427864'}, ) persona = r.json()
const res = await fetch('https://ruc.factornube.com/api/dni', { method: 'POST', headers: { 'Authorization': 'Bearer TU_TOKEN', 'Content-Type': 'application/json', }, body: JSON.stringify({ dni: '27427864' }), }); const persona = await res.json();
fetch('https://ruc.factornube.com/api/dni', { method: 'POST', headers: { 'Authorization': 'Bearer TU_TOKEN', 'Content-Type': 'application/json', }, body: JSON.stringify({ dni: '27427864' }), }) .then(r => r.json()) .then(persona => console.log(persona));
{
"success": true,
"data": {
"id": "27427864",
"nombres": "JOSE PEDRO",
"appat": "CASTILLO",
"apmat": "TERRONES",
"fecnac": "19/10/1969",
"ubigeo": "060615",
"genero": "M"
}
}
curl --request POST \ --url https://ruc.factornube.com/api/ruc \ --header 'Authorization: Bearer TU_TOKEN' \ --header 'Content-Type: application/json' \ --data '{"ruc": "20552103816"}'
<?php $ch = curl_init('https://ruc.factornube.com/api/ruc'); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_POST => true, CURLOPT_HTTPHEADER => [ 'Authorization: Bearer TU_TOKEN', 'Content-Type: application/json', ], CURLOPT_POSTFIELDS => json_encode(['ruc' => '20552103816']), ]); $empresa = json_decode(curl_exec($ch), true); curl_close($ch);
import requests r = requests.post( 'https://ruc.factornube.com/api/ruc', headers={'Authorization': 'Bearer TU_TOKEN'}, json={'ruc': '20552103816'}, ) empresa = r.json()
const res = await fetch('https://ruc.factornube.com/api/ruc', { method: 'POST', headers: { 'Authorization': 'Bearer TU_TOKEN', 'Content-Type': 'application/json', }, body: JSON.stringify({ ruc: '20552103816' }), }); const empresa = await res.json();
fetch('https://ruc.factornube.com/api/ruc', { method: 'POST', headers: { 'Authorization': 'Bearer TU_TOKEN', 'Content-Type': 'application/json', }, body: JSON.stringify({ ruc: '20552103816' }), }) .then(r => r.json()) .then(empresa => console.log(empresa));
{
"success": true,
"data": {
"ruc": "20552103816",
"razonSocial": "AGROLIGHT PERU S.A.C.",
"tipo": "SOCIEDAD ANONIMA CERRADA",
"estado": "ACTIVO",
"condicion": "HABIDO",
"direccion": "PJ. JORGE BASADRE NRO. 158...",
"departamento": "LIMA",
"provincia": "LIMA",
"distrito": "SANTA ANITA",
"fechaInscripcion": "2013-03-20...",
"actEconomicas": ["..."]
}
}
| Código | Significado | Respuesta |
|---|---|---|
200 | Consulta exitosa | {"success": true, "data": {...}} |
401 | Token faltante o no autorizado | {"success": false, "message": "Token no autorizado"} |
403 | Token suspendido | {"success": false, "message": "Token suspendido..."} |
422 | DNI/RUC con formato inválido | {"success": false, "message": "El campo \"dni\" debe tener 8 dígitos"} |
502 | Fuente oficial no disponible | {"success": false, "message": "No se pudo consultar..."} |
Pensada para negocios que facturan
No somos solo una API: somos el socio de validación de datos de tu sistema de facturación.
Token propio y rastreable
Cada empresa recibe su token exclusivo. Sabes exactamente quién consulta, qué y cuándo.
Historial completo
Cada consulta queda registrada con fecha, tipo y documento. Recibe tu detalle mensual para conciliar tu facturación.
Integración en minutos
Un endpoint, un token, JSON limpio. Funciona con PHP, Python, Node.js, Java, C# o el lenguaje que uses.
Seguridad primero
HTTPS obligatorio, tokens revocables al instante y datos protegidos en el servidor.
Soporte directo
Hablas directo con quien opera el servicio, por WhatsApp o correo. Sin tickets que nadie responde.
Sin contratos forzosos
Planes flexibles y sin permanencia. Escala cuando tu negocio lo necesite.
Planes simples, sin sorpresas
Todos los planes incluyen acceso a las APIs de DNI y RUC, token propio e historial de consultas. Precios en soles, factura disponible.
Emprendedor
- API DNI y RUC
- Token propio rastreable
- Historial de consultas
- Soporte por correo
Negocio
- API DNI y RUC
- Token propio rastreable
- Historial de consultas
- Soporte prioritario WhatsApp
- Reporte mensual para facturación
Empresa
- Todo lo del plan Negocio
- Múltiples tokens por áreas
- SLA y atención directa
- Facturación mensual con detalle
Preguntas frecuentes
Todo lo que necesitas saber antes de integrar.
Empieza a consultar hoy mismo
Solicita tu token y en minutos estarás validando RUC y DNI directamente desde tu sistema.