Cómo consultar si un RUC es contribuyente especial

Qué significa ser contribuyente especial

Un contribuyente especial es una persona o entidad calificada como tal por la administración tributaria. Esta condición es distinta del tipo de contribuyente y de la designación de agente de retención.

Un mismo RUC puede tener ambas calificaciones, solo una o ninguna. Consulta cada dato por separado y vuelve a verificarlo cuando su vigencia sea importante.

Cómo consultarlo desde la página

• Abre la página para consultar contribuyentes especiales.
• Inicia sesión con una cuenta cuyo correo esté confirmado.
• Ingresa los 13 dígitos del RUC, sin espacios ni guiones.
• Presiona Consultar y revisa si el resultado indica que consta como contribuyente especial.
• Confirma la razón social y el estado para asegurarte de que verificaste el RUC correcto.

Cómo consultarlo mediante la API

Envía una solicitud GET a /api/v1/rucs/{ruc}/contribuyente-especial y autentícala con tu API key en el encabezado Authorization.

La respuesta usa claves en inglés. is_special_taxpayer es true cuando el RUC consta como contribuyente especial y false cuando no consta.

curl "https://api.ecuadorapi.com/api/v1/rucs/1790012345001/contribuyente-especial" \
  -H "Authorization: Bearer $ECUADORAPI_KEY"

const response = await fetch("https://api.ecuadorapi.com/api/v1/rucs/1790012345001/contribuyente-especial", {
  headers: {
    Authorization: "Bearer " + process.env.ECUADORAPI_KEY,
  },
})
const { data } = await response.json()

import os
import requests

response = requests.get(
    "https://api.ecuadorapi.com/api/v1/rucs/1790012345001/contribuyente-especial",
    headers={"Authorization": f"Bearer {os.environ['ECUADORAPI_KEY']}"},
)
data = response.json()["data"]

$ch = curl_init("https://api.ecuadorapi.com/api/v1/rucs/1790012345001/contribuyente-especial");
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("ECUADORAPI_KEY")],
    CURLOPT_RETURNTRANSFER => true,
]);
$body = json_decode(curl_exec($ch), true);
curl_close($ch);
$data = $body["data"];

{
  "data": {
    "id": "1790012345001",
    "business_name": "EJEMPLO COMERCIAL S.A.",
    "status": "ACTIVO",
    "is_special_taxpayer": true,
    "fetched_at": "2026-09-14T16:00:00Z"
  },
  "error": null,
  "message": null
}

Cómo interpretar la respuesta

• id es el RUC que se verificó.
• business_name permite confirmar la razón social consultada.
• status muestra el estado tributario disponible del contribuyente.
• is_special_taxpayer contiene el resultado booleano de la verificación.
• fetched_at indica cuándo se obtuvo la información.

Errores y buenas prácticas

• Valida que el RUC tenga exactamente 13 dígitos antes de llamar al endpoint.
• Maneja un 400 como formato inválido y un 404 como RUC sin información disponible.
• Reintenta los errores temporales con espera progresiva, sin enviar ráfagas de solicitudes.
• No guardes el resultado indefinidamente: la calificación tributaria puede actualizarse.