Búsqueda de contribuyentes RUC Paraguay

API pública

Documentación del API

Busca por nombre o RUC, recibe JSON simple para integrar y consulta fichas exactas con respuestas rápidas. Datos visibles actualizados al 09/09/26.

Una API preparada para integrar

Búsqueda flexible

Consulta por RUC o por nombre desde tus sistemas.

JSON simple

Respuestas claras con los datos que ya ofrece la API.

Uso predecible

Consultas rápidas, límites mensuales claros y opciones para crecer.

GET /api/search?q=

Busca por nombre o por RUC. Devuelve coincidencias ordenadas y cada resultado incluye name, ruc, dv, fullRuc, state y publicationDateText.

curl "https://ruc.sun.com.py/api/search?q=ferreteria"

GET /api/ruc/:fullRuc

Devuelve una ficha exacta por RUC-DV o por RUC si existe una coincidencia exacta. Cuando el registro tiene una designación de facturación electrónica importada, incluye sifenMandate con grupo, fecha de inicio y enlace de referencia. Cuando existe una coincidencia SIARA sincronizada, siara contiene únicamente grupo, categoría, tipo jurídico, departamento, ciudad, estado SIARA, última comunicación, fecha de sincronización y enlace al registro fuente.

curl "https://ruc.sun.com.py/api/ruc/80012345-6"
curl -H "X-API-Key: TU_API_KEY" "https://ruc.sun.com.py/api/ruc/80012345-6"

GET /api/search/count?q=

Devuelve solo el total de coincidencias para una consulta y filtros de estado.

curl "https://ruc.sun.com.py/api/search/count?q=acme"

Precios mensuales

Planes para uso de la API

Elige un límite predecible para tu integración y solicita mayor volumen cuando lo necesites.

Gratis

Gs. 0 100 consultas/mes

Para desarrollo y pruebas.

Starter

Gs. 100.000/mes 10.000 consultas/mes

Para integraciones pequeñas.

Empresa

Gs. 300.000/mes 100.000 consultas/mes

Para integraciones regulares en producción.

Alto volumen

Consultar Más de 100.000 consultas/mes

Para sistemas grandes, uso masivo o requisitos personalizados.

Para contratar un plan, escribe a ruc@sun.com.py indicando el plan deseado.

Notas

state=ACTIVO o múltiples state= permiten filtrar por estado. Si no envías estados, la búsqueda revisa todos los estados disponibles.