API de consultas del Perú
API de consulta RUC y DNI, y mucho más
Personas, empresas, dólar y comprobantes del Perú en JSON. Una línea de código.
Tipo de cambio
El dólar SUNAT y SBS en tu sistema
Compra y venta oficiales para tu facturador o tu contabilidad: de hoy, de un mes completo o de un rango de fechas.
Validar comprobantes
Valida comprobantes en SUNAT
Si la factura o boleta es válida, su estado y el del emisor. Uno por uno o miles de una vez desde un Excel.
Descarga de comprobantes
XML, CDR y PDF de tus comprobantes
De tus ventas y compras, directo de SUNAT con tu clave SOL guardada en tu cuenta. También armas el PDF desde un XML.
- SUNAT
- SBS
Todo en una sola API
-
Consulta DNI
Nombres, dirección, nacimiento y RUC de una persona.
GET /v1/dni/{numero} -
Consulta RUC
Razón social, estado, condición, locales y representantes.
GET /v1/ruc/{numero} -
Tipo de cambio
Dólar SUNAT y SBS por día, mes o rango.
GET /v1/tipo-cambio/hoy -
Validar comprobantes
Validez en SUNAT, uno por uno o miles desde Excel.
POST /v1/cpe/validez -
XML, CDR y PDF
Descarga tus comprobantes de ventas y compras.
POST /v1/cpe/xml
Integra en minutos
Crea tu token
En tu cuenta, con las IPs que quieras permitir.
Haz la petición
Envía
Bearer cp_…en la cabecera.Recibe JSON
Siempre
{ success, message, result }.
curl "https://api.consultape.pro/v1/ruc/20100047218" \
-H "Authorization: Bearer $CONSULTAPE_TOKEN"const r = await fetch('https://api.consultape.pro/v1/ruc/20100047218', {
headers: { Authorization: `Bearer ${process.env.CONSULTAPE_TOKEN}` },
});
const { success, result } = await r.json();<?php
$ch = curl_init('https://api.consultape.pro/v1/ruc/20100047218');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('CONSULTAPE_TOKEN')],
]);
$datos = json_decode(curl_exec($ch), true);import os, requests
r = requests.get(
"https://api.consultape.pro/v1/ruc/20100047218",
headers={"Authorization": f"Bearer {os.environ['CONSULTAPE_TOKEN']}"},
)
print(r.json()["result"])Hecha para producción
Si la fuente falla, no pagas
Las consultas fallidas no descuentan tu cuota.
Tokens con IPs permitidas
Solo tus servidores pueden usar tu token.
Un solo formato
El mismo JSON en todos los servicios.
Planes
Empieza gratis y sube de plan cuando lo necesites. Las consultas fallidas no descuentan tu cuota. Ver precios
Plan Gratuito
Gratis
- 100 consultas al mes
- Consulta DNI
- Consulta RUC
- Tipo de cambio
Plan Básico
S/ 15/mes
- 50 000 consultas al mes
- Consulta DNI
- Consulta RUC
- Tipo de cambio
- Validez de comprobante
Plan Empresarial
S/ 25/mes
- 100 000 consultas al mes
- Consulta DNI
- DNI por nombres
- Fecha de nacimiento
- RUC por DNI
- Consulta RUC
- RUC completo
- Establecimientos anexos
- Representantes legales
- Tipo de cambio
- Validez de comprobante
- Validez masiva
- Descarga de CDR
- Descarga de XML
- Descarga de PDF
Plan Premium
A consultar
- 250 000 consultas al mes
- Consulta DNI
- DNI por nombres
- Fecha de nacimiento
- RUC por DNI
- Consulta RUC
- RUC completo
- Establecimientos anexos
- Representantes legales
- Ficha RUC (PDF)
- Tipo de cambio
- Validez de comprobante
- Validez masiva
- Descarga de CDR
- Descarga de XML
- Descarga de PDF
Preguntas frecuentes
¿Qué es una API de consulta RUC y DNI?
Un servicio que tu sistema llama por HTTP con un número de RUC o DNI y recibe los datos en JSON, sin entrar a ninguna web ni copiar a mano.
¿Cuánto cuesta ConsultaPe?
Hay planes desde S/ 15/mes con 50 000 consultas al mes. Mira todos en precios.
¿Hay un plan gratis?
Sí. El Plan Gratuito incluye 100 consultas al mes de Consulta DNI, Consulta RUC y Tipo de cambio. Solo creas tu cuenta.
¿De dónde salen los datos? ¿Son oficiales?
De fuentes públicas: SUNAT para RUC, comprobantes y tipo de cambio; SBS para su tipo de cambio. ConsultaPe no es una entidad del Estado: para un trámite, la constancia oficial la da la entidad.
¿Es legal consultar un DNI?
Sí, es común para identificar a un cliente o emitir una boleta. La Ley 29733 de Protección de Datos Personales regula el uso: trátalos solo para un fin legítimo y no los difundas.
¿Qué tan actualizado está el RUC?
Los datos básicos salen del padrón reducido de SUNAT, que se actualiza cada día. La ficha completa se consulta en SUNAT y se reutiliza hasta 7 días.
¿Se integra con mi sistema o facturador?
Sí. Es una API REST con token que funciona con cualquier lenguaje. Muchos facturadores solo necesitan la URL base y el token: ver facturadores.
¿Cómo empiezo?
Crea tu cuenta gratis, genera un token y envíalo en la cabecera Authorization: Bearer. La guía de primeros pasos lo explica en 5 minutos.
¿Me cobran si la fuente no responde?
No. Si SUNAT u otra fuente oficial falla, la respuesta llega con success: false y no se descuenta de tu cuota.
¿Puedo usarla sin programar?
Sí. Desde la web de clientes haces las mismas consultas, validas comprobantes desde Excel y descargas XML, CDR y PDF.
Empieza a consultar hoy
Escríbenos y activamos tu cuenta y tu token.