Saltar al contenido principal
api.factosperu.com · REST + JSON

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.

Token Bearer
29 rutas documentadas
Colección Postman lista

Pruébalo ahora, sin token

No consume consultas de ningún plan.

curl https://api.factosperu.com/api/status
https://api.factosperu.com/api/v1/dni
ejemplo
POST /api/v1/dni 200 OK
{
  "success": true,
  "code": "found",
  "retryable": false,
  "data": {
    "numero": "12345678",
    "nombre_completo": "PEREZ LOPEZ ANA MARIA"
  },
  "time": 0.08
}
API v1 · 1.1.0
https://api.factosperu.com/api/v1
SERVICIOS

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.

DNI

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.

RUC

Consulta RUC

Razón social, estado, condición, dirección fiscal, actividades y si es agente de retención. POST /api/v1/ruc.

CPE

Consulta CPE

PDF, XML y CDR en Base64 de hasta 100 comprobantes por lote, con la Clave SOL del RUC. POST /api/v1/cpe.

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.

BUZÓN

Consulta de buzón

Notificaciones y mensajes del buzón SOL con sus detalles y adjuntos. POST /api/v1/buzon.

IDENTIDAD

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.

SUNAFIL

Casilla SUNAFIL

Notificaciones y documentos de la casilla electrónica SUNAFIL: POST /api/v1/sunafil/casilla y /sunafil/documento.

DATOS

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

CPE de RUC excluido

PDF y XML de comprobantes de emisores exceptuados (p. ej. bancos): POST /api/v1/ruc/excluido.

SOL

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.

ENDPOINTS

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.

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.

Ver detalle y errores

CÓMO FUNCIONA

Tu primera consulta en 3 pasos

Del registro a la primera respuesta JSON, sin instalar nada.

01

Crea una cuenta

Regístrate: la cuenta empieza en el plan Gratuito con 100 consultas al mes.

02

Genera tu token

Créalo en el panel. Se muestra una sola vez; si lo regeneras, el anterior deja de funcionar.

03

Consulta

Envía POST https://api.factosperu.com/api/v1/ruc con tu token, o importa la colección Postman con las 29 rutas.

PARA DESARROLLADORES

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
curl -X POST "https://api.factosperu.com/api/v1/ruc" \
  -H "Authorization: Bearer TU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"ruc":"20123456789"}'
PHP (Laravel)
$response = Http::withToken('TU_TOKEN')
    ->post('https://api.factosperu.com/api/v1/ruc', ['ruc' => '20123456789']);

$data = $response->json();
JavaScript
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();
PRECIOS

Planes que crecen contigo

Precio mensual y servicios incluidos en cada plan.

Gratuito

S/ 0.00 precio mensual

Periodo del plan: No especificado

100
límite mensual configurado
  • 100 consultas mensuales
  • Soporte 24/7
  • Soporte por teléfono / correo
Ver documentación

Micro

S/ 5.00 precio mensual

Periodo del plan: No especificado

2,500
límite mensual configurado
  • 2,500 consultas mensuales
  • Acceso a todas las APIs de consulta
  • Soporte 24/7
  • Soporte por teléfono / correo
Ver documentación

Básico

S/ 15.00 precio mensual

Periodo del plan: No especificado

50,000
límite mensual configurado
  • 50,000 consultas mensuales
  • Acceso a todas las APIs de consulta
  • Soporte 24/7
  • Soporte por teléfono / correo
Ver documentación
MÁS POPULAR

Plus

S/ 25.00 precio mensual

Periodo del plan: No especificado

100,000
límite mensual configurado
  • 100,000 consultas mensuales
  • Acceso a todas las APIs de consulta
  • Soporte 24/7
  • Soporte por teléfono / correo
Ver documentación

Premium

S/ 45.00 precio mensual

Periodo del plan: No especificado

250,000
límite mensual configurado
  • 250,000 consultas mensuales
  • Acceso a todas las APIs de consulta
  • Soporte 24/7
  • Soporte por teléfono / correo
Ver documentación

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.

CONTACTO

¿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.

Al enviar, los datos se guardan para identificar tu solicitud de contacto.