API de consulta de RUC con datos de SUNAT
Necesitas consultar RUC desde tu sistema de facturación, tu ERP o tu tienda, sin descargar ni mantener el padrón de SUNAT. consultaruc expone ese padrón como una API REST: envías el RUC y recibes un JSON.
Qué devuelve
Una consulta a GET /ruc/{id} entrega, para el RUC pedido:
- razón social;
- estado del contribuyente y condición de domicilio;
- domicilio fiscal, con ubigeo, distrito, provincia y departamento (para RUC que empiezan con
20); - si figura como agente de retención del IGV.
Los datos son los del padrón reducido de SUNAT, tal como los publica. Mira todos los campos en la referencia de GET /ruc/{id}.
Cómo integrarla
Una petición GET con tu key:
curl https://consultaruc-api.karvesol.com/ruc/20100000008 -H "Authorization: Bearer sk_tu_clave"
El inicio rápido trae el mismo ejemplo en JavaScript y Python, y la página de errores y límites explica qué hacer con cada código de respuesta.
Precios
Cada consulta consume 1 crédito. Puedes empezar con el plan Free (350 créditos al mes) y pasar a un plan de pago cuando lo necesites, sin permanencia. Revisa los precios.
Preguntas frecuentes
¿Qué datos devuelve la API?
Razón social, estado y condición del contribuyente, domicilio fiscal con ubigeo, distrito, provincia y departamento, y si el RUC figura como agente de retención del IGV.
¿De dónde salen los datos?
Del padrón reducido que publica SUNAT. Se devuelven tal como los publica, sin completar textos abreviados.
¿Cómo me autentico?
Con una API key en la cabecera Authorization: Bearer. La creas en tu cuenta y se muestra una sola vez.
¿Cuánto cuesta consultar un RUC?
Cada consulta consume 1 crédito. El plan Free incluye 350 créditos al mes; los planes de pago empiezan en S/10 al mes.