API de consulta de RUC en Paraguay: confirma la razón social y el RUC completo

Actualizado en noviembre de 2026

Esta guía muestra cómo consultar una empresa en Paraguay por RUC con la API de Verifik: el endpoint, sus parámetros, una solicitud que puedes pegar en la terminal, la respuesta y los errores documentados, y qué revisar al llevarlo a producción. Todo lo que sigue proviene de la documentación oficial del endpoint.

Registros empresariales en Paraguay

El Registro Único del Contribuyente (RUC) de Paraguay lo administra la Dirección Nacional de Ingresos Tributarios (DNIT), que reemplazó a la antigua Subsecretaría de Estado de Tributación (SET). Para personas físicas el RUC es el número de cédula más un dígito verificador; las empresas reciben un número que empieza por 80.

El endpoint de Verifik recibe el RUC sin dígito verificador y devuelve el nombre registrado y el RUC completo con el dígito.

¿Quieres probarlo? Crea tu cuenta en Verifik y haz tu primera consulta hoy.

Cómo consultar la API de RUC de Paraguay

Endpoint: GET https://api.verifik.co/v2/py/company. Envía tu token en la cabecera Authorization: Bearer. Parámetros, según la documentación:

Ejemplo de solicitud con valores de ejemplo (reemplázalos por los datos de tu usuario):

curl --location --request GET 'https://api.verifik.co/v2/py/company?documentType=RUC&documentNumber=80012345' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>'

Respuesta 200 de la documentación (datos personales enmascarados):

{
  "data": {
    "businessName": "EMPRESA EJEMPLO S.A.",
    "documentNumber": "80012345",
    "documentType": "RUC",
    "fullRUC": "80012345-6"
  },
  "signature": {
    "dateTime": "October 10, 2025 5:32 PM",
    "message": "Certified by Verifik.co"
  },
  "id": "NI85Y"
}

Una consulta exitosa devuelve HTTP 200 con un objeto data que contiene: businessName, documentNumber, documentType, fullRUC. Toda respuesta incluye además una signature (fecha y “Certified by Verifik.co”) y un id único que puedes guardar como evidencia de la verificación.

Errores documentados de /v2/py/company

• 401 UNAUTHORIZED (“Authentication required”): falta el token o no es válido; revisa la cabecera Authorization.
• 404 NotFound (“Record not found”): no se encontró registro; no lo trates como coincidencia y envía el caso a revisión o pide otro documento.
• 409 MissingParameter (“documentType must be one of: [RUC]”): falta un parámetro obligatorio o tiene un valor no válido; corrige la solicitud en vez de reintentarla igual.
• 500 InternalServerError (“Server error”): error del servidor o de la fuente; reintenta con backoff y registra el id de la solicitud.

Consejos de integración

• Envía el RUC sin dígito verificador; la respuesta devuelve fullRUC con él.
• Un RUC que no empieza por 80 suele ser de una persona física; revisa si eso es lo esperado.
• documentType debe ser RUC.
• Para personas físicas, combínalo con la consulta de CIC de Paraguay para confirmar a la persona detrás del RUC.

Datos personales y términos de uso

Los registros empresariales pueden incluir datos personales de socios, dignatarios o representantes. Usa la API solo con una finalidad legítima que puedas documentar, como onboarding, prevención de fraude o verificación contractual, obtén el consentimiento cuando la ley local lo exija y conserva solo los campos que necesites. El uso se rige por los términos y condiciones de smartCHECK.

Precios

Cada solicitud exitosa consume créditos de tu plan de Verifik. Los planes vigentes y el costo por endpoint están en la página de precios de smartCHECK.

Guías y documentación relacionadas

• API de verificación de CIC paraguaya
• API de consulta de NIT en Bolivia
• Documentación del endpoint (español)
• Documentación en inglés

Empieza a probar

Crea una cuenta en Verifik para obtener tu token de API, o agenda una reunión si quieres revisar cobertura y volúmenes con el equipo.