Documentacion de la API

8 endpoints JSON sobre los mismos datos que las herramientas web. Requieren una API key gratuita (5 consultas diarias por key).

¿No tienes key todavia?

Iniciar sesion con Google →

Toda peticion lleva el header X-Api-Key: TU_KEY (o el parametro api_key si no puedes mandar headers personalizados).

GET/POST/api/cedula.php

Nombre y datos de contacto asociados a una cedula (10 digitos) o RUC (13 digitos).

curl -H "X-Api-Key: TU_KEY" "https://demosridr.hexasoft-dev-ec.com/api/cedula.php?cedula=1712345678"

GET/POST/api/placa.php

Marca, modelo, año y valores pendientes de pago de un vehiculo por placa (SRI), mas color, clase, servicio, fechas de matricula/caducidad y citaciones de transito (ANT).

curl -H "X-Api-Key: TU_KEY" "https://demosridr.hexasoft-dev-ec.com/api/placa.php?placa=ABC1234"

GET/POST/api/ruc.php

Datos publicos de un contribuyente y sus establecimientos.

curl -H "X-Api-Key: TU_KEY" "https://demosridr.hexasoft-dev-ec.com/api/ruc.php?ruc=1792146739001"

GET/POST/api/emisor.php

Si un RUC esta habilitado como emisor de comprobantes electronicos.

curl -H "X-Api-Key: TU_KEY" "https://demosridr.hexasoft-dev-ec.com/api/emisor.php?ruc=1792146739001"

GET/POST/api/validador.php

Valida una clave de acceso (49 digitos) de un comprobante electronico.

curl -H "X-Api-Key: TU_KEY" "https://demosridr.hexasoft-dev-ec.com/api/validador.php?clave_acceso=1234...(49 digitos)"

POST/api/estado_tributario.php

Deudas firmes, obligaciones vigentes y alertas de vencimiento. Requiere tu propio RUC/clave del SRI (nunca se guardan). Solo POST, nunca por la URL.

curl -X POST -H "X-Api-Key: TU_KEY" \
  --data "ruc=0999999999001&clave=TU_CLAVE_SRI" \
  "https://demosridr.hexasoft-dev-ec.com/api/estado_tributario.php"

POST/api/anulados.php

Comprobantes anulados (emitidos y recibidos) de un periodo. Requiere tu propio RUC/clave del SRI.

curl -X POST -H "X-Api-Key: TU_KEY" \
  --data "ruc=0999999999001&clave=TU_CLAVE_SRI&anio=2026&mes=7" \
  "https://demosridr.hexasoft-dev-ec.com/api/anulados.php"

POST/api/comprobantes.php

Lista de comprobantes recibidos de un tipo/periodo (sin descarga de XML/RIDE). Requiere tu propio RUC/clave del SRI. Valores validos de tipo: Factura, Liquidacion de compra, Notas de Credito, Notas de Debito, Comprobante de Retencion.

curl -X POST -H "X-Api-Key: TU_KEY" \
  --data "ruc=0999999999001&clave=TU_CLAVE_SRI&anio=2026&mes=7&tipo=Factura" \
  "https://demosridr.hexasoft-dev-ec.com/api/comprobantes.php"

Respuestas: siempre JSON con {"ok": true, "datos": {...}} o {"ok": false, "error": "..."}. Codigos: 400 (parametro invalido), 401 (key invalida/faltante), 404 (sin resultados), 429 (limite diario alcanzado), 500/502 (error al consultar al SRI).