API pública

Documentación del API

API simple para buscar por nombre o RUC y consultar una ficha exacta. Fecha visible más reciente publicada por DNIT: 01/05/26.

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 DNIT designó el RUC como facturador electrónico en una resolución importada, incluye sifenMandate con grupo, fecha de inicio y enlace al anexo oficial.

curl "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"

Notas

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