Deja de copiar razones sociales a mano. Con nuestra API de consultas RUC y DNI tu facturador, ERP, tienda online o formulario web autocompleta los datos del cliente con solo escribir el número: razón social, estado y condición SUNAT para RUC, y nombres y apellidos para DNI.
API consulta DNI
Escribe el número de DNI y recibe nombres y apellidos en JSON. Ideal para emitir boletas, registrar clientes o validar la identidad de un usuario sin tipeo.
Devuelve: nombres apellido_paterno apellido_materno nombre_completo codigo_verificacion fecha_nacimiento edad ruc
- GET
/v1/dni/{numero}Nombres, apellido paterno, apellido materno y nombre completo. - GET
/v1/dni/{numero}/fecha-nacimientoFecha de nacimiento y edad de la persona. - GET
/v1/dni/{numero}/rucRUC 10 de la persona y su razón social, si está inscrita en SUNAT. - POST
/v1/dni/buscar-por-nombreEncuentra el número de DNI a partir de nombres y apellidos.
API consulta RUC
Consulta un RUC 10 o RUC 20 y obtén en milisegundos los datos del contribuyente en SUNAT: si está ACTIVO y HABIDO, su dirección fiscal, actividades económicas, locales anexos y representantes legales.
Devuelve: razon_social nombre_comercial estado condicion direccion_completa ubigeo tipo_contribuyente fecha_inscripcion actividades_economicas sistema_emision_comprobante establecimientos representantes
- GET
/v1/ruc/{numero}Razón social, estado, condición y dirección fiscal. - GET
/v1/ruc/{numero}/completoFicha completa: actividades económicas, sistemas de emisión y fechas. - GET
/v1/ruc/{numero}/establecimientosLocales y establecimientos anexos del contribuyente. - GET
/v1/ruc/{numero}/representantesRepresentantes legales de la empresa.
Antes de consultar se valida el dígito verificador del RUC: si el número no cuadra, la API responde con error 400 sin descontar tu cuota.
API ficha RUC
Descarga la ficha RUC en PDF directamente desde SUNAT Operaciones en Línea, lista para trámites, certificados digitales o expedientes de clientes. La clave SOL se guarda cifrada.
- POST
/v1/ruc/fichaFicha RUC en PDF desde SOL (SUNAT permite hasta 3 fichas por día por RUC).
¿Solo necesitas una ficha puntual? Usa nuestra herramienta gratuita para descargar la ficha RUC con QR.
Cómo integrar la consulta RUC y DNI en tu sistema
- 1. Crea tu cuenta gratis y genera un token desde el panel.
- 2. Envía el token en la cabecera
Authorization: Bearer. - 3. Recibe JSON con la misma estructura en todos los endpoints:
{ success, message, result }.
curl "https://api.consultape.pro/v1/ruc/20100047218" \
-H "Authorization: Bearer $CONSULTAPE_TOKEN"
<?php
$ch = curl_init('https://api.consultape.pro/v1/dni/45781236');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('CONSULTAPE_TOKEN')],
]);
$datos = json_decode(curl_exec($ch), true);
Hay ejemplos en curl, JavaScript, PHP y Python, y especificación OpenAPI en la documentación.
Por qué usar nuestra API de consultas
- Si la fuente falla, no pagas: las consultas fallidas no descuentan tu cuota.
- Tokens con IPs permitidas: restringe cada token a los servidores que tú autorices.
- Respuesta unificada: el mismo formato JSON para DNI, RUC, tipo de cambio y comprobantes.
- Sin programar también: haz consultas desde la web de clientes cuando lo necesites.
- Más que DNI y RUC: tipo de cambio SUNAT/SBS, validez de comprobantes y descarga de XML, CDR y PDF.
Si emites comprobantes, combínala con nuestro sistema de facturación electrónica o consulta la validez de un CPE en SUNAT.
Preguntas frecuentes sobre consultas DNI y RUC
¿Cómo hago una consulta RUC en línea?
Envía el número de RUC de 11 dígitos a GET /v1/ruc/{numero} con tu token en la cabecera Authorization: Bearer. En milisegundos recibes la razón social, el estado (ACTIVO), la condición (HABIDO) y la dirección fiscal en JSON.
¿Cómo hago una consulta DNI para obtener nombres y apellidos?
Llama a GET /v1/dni/{numero} con el DNI de 8 dígitos. La respuesta trae nombres, apellido paterno, apellido materno y nombre completo, listos para autocompletar formularios o boletas.
¿Qué significa ACTIVO y HABIDO en la consulta RUC?
ACTIVO es el estado del contribuyente en SUNAT; HABIDO indica que su domicilio fiscal fue verificado. Ambos datos vienen en cada consulta RUC.
¿Puedo obtener el RUC de una persona a partir de su DNI?
Sí. Con /v1/dni/{numero}/ruc recibes el RUC 10 de la persona y su razón social, si está inscrita en SUNAT.
¿Puedo descargar la ficha RUC en PDF?
Sí, con POST /v1/ruc/ficha y la clave SOL del contribuyente (se guarda cifrada). SUNAT permite hasta 3 fichas por día por RUC.
¿Me cobran si SUNAT no responde o el número no existe?
No. Si la fuente oficial falla o el documento no existe, la respuesta llega con success: false y esa consulta no se descuenta de tu cuota.
¿Puedo usar las consultas DNI y RUC sin programar?
Sí. Desde la web de clientes haces las mismas consultas manualmente, sin escribir código. La API es para integrarlo en tu sistema, ERP, web o facturador.