🇵🇪PerúPOST /v1/pe/ruc

SUNAT Consulta RUC desde DNI

Obtén el RUC, razón social, estado y dirección fiscal de cualquier contribuyente peruano a partir de su DNI. Datos en tiempo real desde SUNAT.

Tomás Calle

Founder · Croma

Esta es una demo pública con ratelimit reducido. Para una API key de producción, agenda una llamada. Te respondo el mismo día.

tomas@usecroma.com+57 317 512 6894

Agendar 15 min

Guía para integrar

Fuente: SUNAT Perú.
Actualización: Consulta bajo demanda contra la fuente oficial cuando el endpoint se ejecuta.
Latencia: Normalmente segundos; depende de disponibilidad de la fuente oficial.
Autenticación: Bearer API key en el header Authorization.

Casos de uso

Consultar RUC desde DNI o número tributario.
Validar razón social, estado y condición tributaria.
Integrar verificación de contribuyentes peruanos.

Parámetros de entrada

document_numberstringreq: DNI o documento del contribuyente, 8 dígitos.

Campos de respuesta

rucstring: Número RUC encontrado.
namestring: Razón social o nombre del contribuyente.
typestring: Tipo de contribuyente (persona natural / jurídica).
statusstring: Estado del contribuyente (activo, baja, etc.).
conditionstring: Condición tributaria (habido, no habido).
fiscal_addressstring: Dirección fiscal reportada por SUNAT.

Preguntas frecuentes

¿Qué devuelve la API de RUC Perú?

Devuelve RUC, razón social, tipo de contribuyente, estado, condición y dirección fiscal cuando la fuente oficial tiene datos disponibles.

¿Qué formato acepta document_number?

Acepta un documento numérico de 8 dígitos. Se envía como string en el cuerpo JSON.

Probar

Resultado

Edita el JSON y envíalo para ver los datos del contribuyente.

Referencia

curl https://api.usecroma.com/v1/pe/ruc \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"document_number":"74849152"}'