Consulta DNI, RUC y comprobantes SUNAT
Una sola API en https://api.factosperu.com para DNI, RUC (padrón SUNAT y consulta en línea), comprobantes electrónicos, buzón SOL y casilla SUNAFIL: 29 rutas con el mismo token y la misma respuesta JSON.
Pruébalo ahora, sin token
No consume consultas de ningún plan.
curl https://api.factosperu.com/api/status
{ "success": true, "code": "found", "retryable": false, "data": { "numero": "12345678", "nombre_completo": "PEREZ LOPEZ ANA MARIA" }, "time": 0.08 }
Todo lo que necesitas en una sola API
Rutas HTTP autenticadas para identidad (RUC, DNI, carnet, pasaporte), comprobantes, buzón SOL, casilla SUNAFIL, padrón y datos públicos.
Consulta DNI
Nombres y apellidos por número de DNI: primero el padrón reducido y, si no está, SUNAT en línea. POST /api/v1/dni.
Consulta RUC
Razón social, estado, condición, dirección fiscal, actividades y si es agente de retención. POST /api/v1/ruc.
Consulta CPE
PDF, XML y CDR en Base64 de hasta 100 comprobantes por lote, con la Clave SOL del RUC. POST /api/v1/cpe.
Validación múltiple CPE
Estado de hasta 100 comprobantes en SUNAT, más estado y domicilio del emisor. POST /api/v1/validacion-multiple-cpe.
Consulta de buzón
Notificaciones y mensajes del buzón SOL con sus detalles y adjuntos. POST /api/v1/buzon.
Carnet, pasaporte y cédula
Contribuyente inscrito con carnet de extranjería, pasaporte o cédula diplomática: POST /api/v1/carnet-extranjeria, /pasaporte y /cedula-diplomatica.
Casilla SUNAFIL
Notificaciones y documentos de la casilla electrónica SUNAFIL: POST /api/v1/sunafil/casilla y /sunafil/documento.
Padrón y datos públicos
Padrón reducido, búsqueda por razón social, establecimientos, SSCO, ubigeos, puertos, aeropuertos y tipo de cambio (GET /api/v1/tipo-cambio/actual).
CPE de RUC excluido
PDF y XML de comprobantes de emisores exceptuados (p. ej. bancos): POST /api/v1/ruc/excluido.
Credenciales API SUNAT
Extrae, crea o edita el ID y la clave de la aplicación de API SUNAT del RUC: POST /api/v1/credenciales-api, /crear y /editar.
Todas las rutas, con ejemplos
Base https://api.factosperu.com · token Bearer · JSON. Cada ruta tiene ejemplos listos en cURL, PHP y JavaScript, sin iniciar sesión.
Identidad
- POST /api/v1/ruc — Consulta RUC
- POST /api/v1/ruc-sunat — Consulta RUC (ficha SUNAT)
- POST /api/v1/dni-ruc — Consulta RUC por DNI
- POST /api/v1/dni — Consulta DNI
- POST /api/v1/carnet-extranjeria — Consulta por Carnet de Extranjería
- POST /api/v1/pasaporte — Consulta por Pasaporte
- POST /api/v1/cedula-diplomatica — Consulta por Cédula Diplomática de Identidad
- POST /api/v1/razon-social — Búsqueda por razón social en línea
Consultas por GET
Cómo usarlas en tu sistema
Pon la URL base https://api.factosperu.com y envía tu token con Authorization: Bearer TU_TOKEN. La ruta y el formato son los mismos de la página de catálogo.
DNI y RUC devuelven ubigeo como códigos [departamento, provincia, distrito], o null si no hay dato. direccion vale "" si no hay dato.
Sistemas compatibles: pro7, pro8 y Pro9 (formato verificado con su código de integración). SMART, QPOS y Facturador PRO: en verificación.
Comprobantes
Casilla SUNAFIL
Credenciales API SUNAT
Padrón y datos públicos
- POST /api/v1/padron/ruc — Consulta RUC en el Padrón Reducido
- GET /api/v1/padron/buscar — Búsqueda por razón social
- GET /api/v1/ruc/{ruc}/establecimientos — Establecimientos anexos de un RUC
- GET /api/v1/ssco/{ruc} — Sujeto sin capacidad operativa (SSCO)
- GET /api/v1/ubigeos — Ubigeos (INEI)
- GET /api/v1/puertos — Puertos (MTC)
- GET /api/v1/aeropuertos — Aeropuertos (MTC)
- GET /api/v1/tipo-cambio — Tipo de cambio
- GET /api/v1/tipo-cambio/actual — Tipo de cambio actual
Tu primera consulta en 3 pasos
Del registro a la primera respuesta JSON, sin instalar nada.
Crea una cuenta
Regístrate: la cuenta empieza en el plan Gratuito con 100 consultas al mes.
Genera tu token
Créalo en el panel. Se muestra una sola vez; si lo regeneras, el anterior deja de funcionar.
Consulta
Envía POST https://api.factosperu.com/api/v1/ruc con tu token, o importa la colección Postman con las 29 rutas.
Hecha para desarrolladores
Todas las rutas parten de https://api.factosperu.com/api/v1,
piden Authorization: Bearer y responden con
success, code, data y time.
Errores con código
Cada error trae un code estable y retryable para decidir si reintentar.
Token Bearer
Un token por cuenta, enviado en Authorization. Sin token o inválido: 401.
Límite mensual
Cada consulta descuenta una unidad del plan (en lote CPE, una por comprobante). Al agotarlo la API responde 429 limite_alcanzado.
Rutas de consulta
RUC, DNI, carnet, pasaporte, cédula, razón social, CPE, validación múltiple, RUC excluido, buzón, SUNAFIL, padrón y datos públicos.
Ejemplos sin registrarte
El catálogo público muestra cada ruta con cURL, PHP, JavaScript y la respuesta.
curl -X POST "https://api.factosperu.com/api/v1/ruc" \ -H "Authorization: Bearer TU_TOKEN" \ -H "Content-Type: application/json" \ -d '{"ruc":"20123456789"}'
$response = Http::withToken('TU_TOKEN') ->post('https://api.factosperu.com/api/v1/ruc', ['ruc' => '20123456789']); $data = $response->json();
const res = await fetch('https://api.factosperu.com/api/v1/dni', { method: 'POST', headers: { 'Authorization': 'Bearer TU_TOKEN', 'Content-Type': 'application/json' }, body: JSON.stringify({ dni: '12345678' }) }); const data = await res.json();
Planes que crecen contigo
Precio mensual y servicios incluidos en cada plan.
Gratuito
Periodo del plan: No especificado
- 100 consultas mensuales
- Soporte 24/7
- Soporte por teléfono / correo
Micro
Periodo del plan: No especificado
- 2,500 consultas mensuales
- Acceso a todas las APIs de consulta
- Soporte 24/7
- Soporte por teléfono / correo
Básico
Periodo del plan: No especificado
- 50,000 consultas mensuales
- Acceso a todas las APIs de consulta
- Soporte 24/7
- Soporte por teléfono / correo
Plus
Periodo del plan: No especificado
- 100,000 consultas mensuales
- Acceso a todas las APIs de consulta
- Soporte 24/7
- Soporte por teléfono / correo
Premium
Periodo del plan: No especificado
- 250,000 consultas mensuales
- Acceso a todas las APIs de consulta
- Soporte 24/7
- Soporte por teléfono / correo
Cada consulta descuenta una unidad del plan; en un lote de CPE, una por comprobante.
PREGUNTAS FRECUENTES
Antes de integrar
Autenticación, consumo y plan gratuito.
¿Qué consultas ofrece la API?
RUC y DNI (primero el padrón reducido y luego SUNAT en línea), carnet de extranjería, pasaporte y cédula diplomática, razón social, comprobantes electrónicos y su validación múltiple, CPE de RUC excluido, buzón SOL, casilla SUNAFIL, padrón y datos públicos (establecimientos, SSCO, ubigeos, puertos, aeropuertos y tipo de cambio). Cada endpoint tiene parámetros y ejemplos públicos.
Ver catálogo de endpoints con ejemplos¿Cómo autentico mis solicitudes?
Usa tu token como Bearer token en el encabezado Authorization. El panel permite generarlo y mostrarlo una sola vez; si lo regeneras, el anterior deja de funcionar.
¿Cómo se cuentan las consultas?
Cada consulta representada consume una unidad. En una solicitud por lote de CPE se cuenta cada comprobante enviado.
¿Qué incluye el plan Gratuito?
Las nuevas cuentas reciben 100 consultas por mes calendario. La cuota se renueva al comenzar el mes siguiente cuando se realiza la primera solicitud API de ese período.
¿Tienes preguntas sobre la API?
Cuéntanos qué necesitas consultar y te respondemos por correo.
Escríbenos
Completa los campos para registrar tu solicitud de contacto.