Cómo elegir una API de consulta RUC y DNI en Perú (guía 2026)

Tu sistema necesita saber si un RUC está activo, cómo se llama exactamente la empresa o quién es el titular de un DNI. Buscar en Google "mejor API de consulta RUC en Perú" devuelve una decena de proveedores que, a primera vista, hacen lo mismo. La diferencia aparece después: en la factura rechazada por una razón social desactualizada, en los créditos que vencieron sin usarse o en el ticket de soporte que nadie responde.

Esta guía te da un método para decidir con cabeza fría: qué criterios pesan de verdad, qué preguntas hacerle a cada proveedor, una tabla para puntuarlos y una prueba de cinco minutos que revela más que cualquier página de ventas. Al final te contamos cómo responde endpoint.pe a cada punto, para que compares con los mismos criterios que aplicarías a cualquiera.

---

Por qué una API y no la consulta manual

Consultar un RUC en la web de SUNAT o un DNI en los servicios de RENIEC es gratis y funciona bien cuando tienes tres clientes nuevos a la semana. Deja de funcionar cuando tienes trescientos, cuando el dato lo necesita un sistema (y no una persona) o cuando el error de tipeo cuesta una nota de crédito.

Una API resuelve tres cosas que la consulta manual no puede:

• Velocidad. El dato llega en el momento en que el vendedor escribe el número, no cuando alguien se acuerda de revisarlo.
• Consistencia. La razón social entra tal como figura en la fuente oficial, sin abreviaturas inventadas ni tildes perdidas.
• Automatización. Puedes validar un cliente antes de numerar la factura, actualizar tu base de proveedores de noche o alertar cuando un RUC pasa a BAJA.

El scraping (leer la web oficial con un script) parece un atajo, pero es frágil: cambia el captcha o el HTML y tu sistema se cae un lunes a las 9 de la mañana. Y descargar el padrón público de SUNAT sirve para cruces masivos, no para saber el estado de hoy de un contribuyente concreto. Si quieres el detalle de cada opción, está en cómo consultar un RUC en SUNAT paso a paso.

Los nueve criterios que importan

No todos pesan igual. Los tres primeros son eliminatorios; el resto separa a un buen proveedor de uno aceptable.

1. Fuentes oficiales y frescura del dato

Pregunta de dónde sale cada campo. El RUC debe venir de SUNAT y el DNI de RENIEC, con una política clara de actualización. Un proveedor que trabaja con una copia antigua del padrón te dirá que un RUC está ACTIVO cuando ya está de baja. Si quieres entender qué devuelve cada estado, lee qué significan ACTIVO y HABIDO.

2. Precio claro por consulta

El modelo de créditos es el más transparente cuando es simple: una consulta, un crédito, en cualquier API. Desconfía de las tablas donde el DNI cuesta 1, el RUC 2 y los representantes legales 5: termina siendo imposible presupuestar. Pregunta también si el precio incluye IGV y qué pasa con el saldo al terminar el mes.

3. Qué pasa con las consultas sin resultado

Es la letra pequeña más cara. Si consultas un RUC que no existe (un error de tipeo del vendedor, por ejemplo) y el proveedor te cobra igual, estás pagando por nada. Lo justo es que una respuesta 404 no consuma créditos.

4. Plan gratis real

Un plan gratis sirve si permite probar en condiciones reales: suficientes consultas, sin tarjeta y sin vencer a los pocos días. Cien o ciento cincuenta consultas al mes bastan para integrar, probar casos límite y enseñárselo al equipo.

5. Cobertura del catálogo

Hoy necesitas RUC y DNI. En seis meses vas a necesitar el tipo de cambio para facturar en dólares, el ubigeo para las guías de remisión y buscar una empresa por su nombre cuando el cliente no sabe su RUC. Un catálogo amplio con el mismo token te ahorra una segunda integración.

6. Documentación y ejemplos en tu lenguaje

Abre la documentación antes de registrarte. Debe tener la URL exacta de cada ruta, los campos de la respuesta, los códigos de error y ejemplos que puedas pegar en PHP, Python, Node.js o curl. Si la documentación es un PDF o un video, pasa al siguiente.

7. Estabilidad y manejo de errores

No te quedes con la promesa de "99,9 % de disponibilidad". Pide una página de estado, pregunta cómo avisan de incidentes y revisa que los errores sean HTTP estándar (401, 404, 429, 5xx) con un mensaje legible. Tu código de reintentos depende de eso; en manejo de errores y reintentos explicamos cómo diseñarlo.

8. Seguridad y protección de datos

La conexión debe ser HTTPS, el token tipo Bearer y la cuenta debe permitir regenerarlo si se filtra. Como vas a consultar datos personales (nombres y apellidos de un DNI), el proveedor debe tratarlos conforme a la Ley 29733 y no guardar más de lo necesario. Lo que te toca a ti está en la ley de protección de datos para desarrolladores.

9. Soporte en español y canal directo

Cuando algo falla a fin de mes, quieres a una persona que entienda qué es una factura electrónica, no un formulario en inglés. Escribe al soporte antes de contratar y mide cuánto tardan en responder.

Tabla para evaluar cualquier proveedor

Puntúa cada criterio de 0 a 2 (no cumple, cumple a medias, cumple) y compara. Las señales de alerta son las que, en nuestra experiencia, más dolores de cabeza causan después.

Si un proveedor saca 0 en fuentes, precio o consultas sin resultado, descártalo aunque brille en el resto.

Manual, scraping, padrón o API: comparativa

Antes de comparar proveedores entre sí, conviene comparar los caminos posibles. Cada uno tiene un lugar.

La API es la opción correcta cuando el dato alimenta un proceso (facturación, alta de clientes, cobranza) y el costo de un error supera al de la consulta. El padrón descargado sigue siendo útil para limpiar una base histórica de miles de registros de una sola vez.

Cómo responde endpoint.pe a cada criterio

Aplicamos la misma tabla a nuestro servicio. Es la información pública de precios y del catálogo; compárala con la de cualquier otro proveedor.

Dos detalles que suelen inclinar la balanza: el plan anual cuesta 10 meses y entrega los créditos de los 12 de una vez, sin tope mensual; y los planes de pago incluyen panel con métricas de uso y factura electrónica.

Prueba de cinco minutos antes de decidir

Ninguna tabla reemplaza a una llamada real. Crea la cuenta gratis, copia el token y ejecuta estas tres consultas con cualquier proveedor que estés evaluando. Con endpoint.pe se ven así:

# 1. Un RUC real y público: debe devolver estado y condición
curl https://api.endpoint.pe/v1/ruc/20131312955 \
  -H "Authorization: Bearer TU_TOKEN"

# 2. Un RUC con formato válido que no existe: debe devolver 404
curl -i https://api.endpoint.pe/v1/ruc/20999999994 \
  -H "Authorization: Bearer TU_TOKEN"

# 3. Sin token: debe devolver 401, no un 200 con un error escondido
curl -i https://api.endpoint.pe/v1/ruc/20131312955

La primera respuesta te dice si las fuentes están al día y qué campos recibes:

{
  "success": true,
  "message": "Consulta exitosa",
  "data": {
    "ruc": "20131312955",
    "razon_social": "SUPERINTENDENCIA NACIONAL DE ADUANAS Y DE ADMINISTRACION TRIBUTARIA - SUNAT",
    "estado": "ACTIVO",
    "condicion": "HABIDO",
    "direccion": "AV. GARCILASO DE LA VEGA NRO. 1472 LIMA - LIMA - LIMA",
    "ubigeo": "150101"
  },
  "meta": {
    "fuente": "SUNAT",
    "consultado_en": "2026-10-12T07:40:12Z",
    "creditos_cobrados": 1,
    "creditos_disponibles": 14621
  }
}

Después de las tres llamadas, revisa tu panel: si la segunda consulta descontó un crédito, ya sabes cómo trata el proveedor las consultas sin resultado. Y mide el tiempo de respuesta desde tu servidor, no desde tu laptop, porque es el que verán tus usuarios.

Si prefieres Python, el mismo chequeo cabe en diez líneas:

import requests

API = "https://api.endpoint.pe/v1"
HEADERS = {"Authorization": "Bearer TU_TOKEN"}

for ruc in ["20131312955", "20999999994"]:
    r = requests.get(f"{API}/ruc/{ruc}", headers=HEADERS, timeout=10)
    print(ruc, r.status_code, r.elapsed.total_seconds(), "s")
    if r.ok:
        print(r.json()["data"]["razon_social"], r.json()["data"]["estado"])

Para pasar de la prueba a la integración, el paso a paso está en cómo integrar una API REST con token en 5 minutos.

En resumen

• Descarta primero por fuentes, precio y consultas sin resultado; después compara catálogo, documentación, errores, seguridad y soporte.
• Un plan gratis sirve si permite probar en condiciones reales: más de cien consultas, sin tarjeta y sin vencer en días.
• La API gana a la consulta manual, al scraping y al padrón cuando el dato alimenta un proceso y el error cuesta dinero.
• Puntúa a cada proveedor con la tabla de criterios y haz la prueba de tres llamadas antes de firmar nada.
• endpoint.pe: 9 APIs, 1 crédito por consulta, 150 consultas gratis al mes sin tarjeta, sin cobro por 404 y créditos prepago que no vencen.

Preguntas frecuentes

¿Cuál es la mejor API de consulta RUC y DNI en Perú?

La que cumpla los criterios de esta guía para tu caso: fuentes oficiales al día, un crédito por consulta, sin cobro por consultas sin resultado, plan gratis sin tarjeta, documentación pública y soporte en español. endpoint.pe está construida sobre esos principios, y puedes comprobarlo con la prueba de tres llamadas antes de pagar un sol.

¿Cuánto cuesta consultar un RUC o un DNI por API?

En endpoint.pe, 1 crédito por consulta en cualquier API. El plan gratis incluye 150 consultas al mes sin tarjeta; el plan Básico cuesta S/ 15 al mes con 20 000 créditos (sin IGV) y hay paquetes prepago desde S/ 8 que no vencen. Los precios completos están en la página de precios.

¿Qué pasa si consulto un RUC o DNI que no existe?

La API responde con un código 404 y esa consulta no se cobra. Es el comportamiento que deberías exigir a cualquier proveedor, porque los errores de tipeo son frecuentes y no son culpa tuya.

¿Puedo probar la API sin registrar una tarjeta?

Sí. La cuenta gratis se crea sin tarjeta y entrega 150 consultas al mes de forma permanente, no solo durante un periodo de prueba. Puedes hacer la primera consulta desde la consulta en vivo incluso antes de registrarte.

¿Cómo consulto un RUC desde PHP, Python o Node.js?

Con una petición GET a la ruta de la API y el token en la cabecera Authorization. Tenemos guías completas para PHP y Laravel, Python y Node.js, con manejo de errores incluido.