API para consultar RUC de Paraguay
Consulta el RUC de cualquier contribuyente paraguayo desde tu sistema: razón social, dígito verificador, estado (activo, cancelado, suspendido o bloqueado), tipo de persona y RUC anterior. Si envías el DV, se valida antes de buscar. Los datos salen del listado de RUC que publica la DNIT: 2,020,504 RUC, actualizados el 31/10/2026.
Para qué sirve
- Facturar electrónicamente con SIFEN: obtener el DV del receptor y comprobar que su RUC esté activo antes de emitir el documento.
- Validar el RUC que te dio un cliente o proveedor, incluido el dígito verificador.
- Autocompletar la razón social cuando el cliente escribe su RUC.
- Encontrar el RUC de una empresa a partir de su nombre.
Consultar un RUC
GET /v1/py/ruc/{ruc}
Acepta el RUC con el dígito verificador después de un guion (80000856-1) o sin él (80000856); los puntos se ignoran. Sin guion, un número de 9 dígitos se toma como RUC más DV, porque ningún RUC tiene más de 8. Si el DV no coincide, la respuesta es 400 sin necesidad de buscar; si el RUC no está en el listado, es 404.
curl -H "X-API-Key: TU_API_KEY" https://idfiscal.com/v1/py/ruc/80000856-1{
"ruc": "80000856",
"dv": 1,
"ruc_completo": "80000856-1",
"razon_social": "BANCO NACIONAL DE FOMENTO",
"tipo_persona": "JURIDICA",
"estado": "ACTIVO",
"ruc_anterior": "BNFG615740D"
}Campos de la respuesta
| Campo | Descripción |
|---|---|
ruc | RUC sin el dígito verificador. Para personas físicas es el número de cédula; algunos RUC de extranjeros terminan en letra (1023860A). |
dv | Dígito verificador. |
ruc_completo | RUC y DV separados por un guion, como se escribe en las facturas. |
razon_social | Razón social, o apellidos y nombres (APELLIDOS, NOMBRES) para personas físicas. |
tipo_persona | JURIDICA (RUC de 8 dígitos que empieza por 80) o FISICA. |
estado | ACTIVO, SUSPENSION TEMPORAL, BLOQUEADO, CANCELADO o CANCELADO DEFINITIVO. |
ruc_anterior | RUC del sistema anterior de la DNIT (letras y números), o null si no tiene. |
Buscar empresas por nombre
GET /v1/py/ruc?q={texto}
curl -H "X-API-Key: TU_API_KEY" "https://idfiscal.com/v1/py/ruc?q=cerveceria&limit=5"La búsqueda solo incluye personas jurídicas. Las personas físicas inscritas en el padrón se pueden validar por número exacto, pero no aparecen en la búsqueda. Ver la referencia de búsqueda para la paginación.
Preguntas frecuentes
- ¿Qué es el RUC?
- El Registro Único de Contribuyentes es el número con el que la DNIT (Dirección Nacional de Ingresos Tributarios, ex SET) identifica a las personas y empresas en Paraguay. Se escribe con un dígito verificador después de un guion. Para las personas físicas coincide con su número de cédula.
- ¿Cómo se calcula el dígito verificador?
- Con el algoritmo módulo 11 de la DNIT. No hace falta calcularlo: la respuesta trae
dvyruc_completo, y si envías el DV, la API lo comprueba. - ¿Sirve para la factura electrónica (SIFEN)?
- Sí: el documento electrónico lleva el RUC del receptor y su DV por separado, y SIFEN rechaza un DV incorrecto. Con esta API los obtienes a partir del RUC o del nombre, sin necesidad de certificado digital.
- ¿De dónde salen los datos?
- Del listado de RUC que la DNIT publica para descarga. Este servicio no está afiliado a la DNIT: toma ese archivo público y lo ofrece como API.
- ¿Cada cuánto se actualizan?
- Cada mes, cuando la DNIT publica el listado nuevo.
- ¿Cuánto cuesta?
- Es gratis, con un límite de 30 consultas por minuto y 1,000 por día. Si necesitas más, escríbenos a soporte@idfiscal.com.
También disponible para RNC de República Dominicana, RUC de Ecuador y CUIT de Argentina, con la misma API key.