API publica

Documentacion del API

API simple para buscar por nombre o RUC y consultar una ficha exacta. Fecha visible mas reciente publicada por DNIT: 1 abr. 2026.

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.

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 multiples state= permiten filtrar por estado. Si no envias estados, la busqueda revisa todos los estados disponibles.