Documentacion de la API

9 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/ruc_cedula.php

Consulta unificada por cedula (10 digitos) o RUC (13 digitos): nombre y datos de contacto (contacto), datos publicos del contribuyente (contribuyente) y sus establecimientos. Para una cedula se busca su RUC de persona natural (cedula + 001). Si alguna fuente falla, se devuelve lo disponible y el motivo en avisos.

Parametro opcional tipo: todo (por defecto, ambas fuentes), ruc (solo datos del RUC y establecimientos; es la opcion mas rapida) o cedula (solo nombre y contacto).

curl -H "X-Api-Key: TU_KEY" "https://demosridr.hexasoft-dev-ec.com/api/ruc_cedula.php?identificacion=1792146739001"
curl -H "X-Api-Key: TU_KEY" "https://demosridr.hexasoft-dev-ec.com/api/ruc_cedula.php?identificacion=1792146739001&tipo=ruc"
curl -H "X-Api-Key: TU_KEY" "https://demosridr.hexasoft-dev-ec.com/api/ruc_cedula.php?identificacion=1712345678&tipo=cedula"

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"

POST/GEThttps://emitidos.hexasoft-dev-ec.com/api/emitidos_trabajo.php

Comprobantes emitidos de un rango de hasta 366 dias, con sus XML y RIDE, procesados en segundo plano (servidor dedicado, misma API key). Requiere tu propio RUC/clave del SRI: se guarda cifrada solo mientras el trabajo corre y se borra al terminar.

1. Crear el trabajo (POST). Cuesta 1 consulta por cada bloque de hasta 31 dias: un mes = 1, un trimestre = 3, un anio = 12 (la respuesta lo indica en consultas_cobradas; si no te alcanzan, responde 429 sin descontar nada). Parametros: ruc, clave, fecha_inicio y fecha_fin (AAAA-MM-DD; o fecha para un solo dia), tipo (Factura, Liquidacion de compra, Notas de Credito, Notas de Debito, Guias de Remision, Comprobante de Retencion), estado (Autorizados, No Autorizados, Por Procesar), opcionales establecimiento y punto_emision (3 digitos) y archivos: ambos (defecto), xml, ride o ninguno. Responde 202 con el id. Maximo 3 trabajos en curso por key.

curl -X POST -H "X-Api-Key: TU_KEY" \
  --data "ruc=0999999999001&clave=TU_CLAVE_SRI&fecha_inicio=2026-01-01&fecha_fin=2026-10-31&tipo=Factura&archivos=ambos" \
  "https://emitidos.hexasoft-dev-ec.com/api/emitidos_trabajo.php"

2. Consultar el avance (GET, no cuenta consultas): estado pasa de pendiente a procesando y luego a terminado (o error / cancelado); progreso trae dias hechos, porcentaje, comprobantes, RIDE y XML. Sin id lista tus ultimos 20 trabajos.

curl -H "X-Api-Key: TU_KEY" "https://emitidos.hexasoft-dev-ec.com/api/emitidos_trabajo.php?id=ID_DEL_TRABAJO"

3. Descargar el resultado (no cuenta consultas): un ZIP con ride/, xml/, comprobantes.json y comprobantes.csv, o solo la lista con &formato=json. Se guarda 48 horas.

curl -H "X-Api-Key: TU_KEY" -o emitidos.zip "https://emitidos.hexasoft-dev-ec.com/api/emitidos_descarga.php?id=ID_DEL_TRABAJO"

Notas: el XML sale del webservice del SRI, que lo guarda entre ~33 y ~55 dias; para comprobantes mas antiguos se busca automaticamente en el Facturador SRI (si se emitieron desde ahi, su XML esta disponible sin limite de antiguedad). Los demas quedan con su RIDE. Si el SRI se cae, el trabajo reintenta solo; si no vuelve, termina con completo: false y la lista en dias_con_error. Revisa siempre avisos.

GET/POST/api/uso.php

Consultas usadas y restantes HOY de tu API key en cada endpoint (cada uno tiene su propio cupo). No consume cupo. Con limite diario ("tipo_limite": "diario") el contador se reinicia cada dia. Si tienes un plan por periodo ("tipo_limite": "plan"), muestra las fechas del plan, los dias restantes y el cupo total usado/restante de cada endpoint incluido.

curl -H "X-Api-Key: TU_KEY" "https://demosridr.hexasoft-dev-ec.com/api/uso.php"
{"ok": true, "datos": {"fecha": "2026-11-12", "limite_general": 5, "endpoints": {
  "ruc_cedula": {"limite": 5, "usadas": 2, "restantes": 3},
  "cedula": {"limite": 5, "usadas": 0, "restantes": 5}, ...}}}

Respuestas: siempre JSON con {"ok": true, "datos": {...}} o {"ok": false, "error": "..."}. Codigos: 400 (parametro invalido), 401 (key invalida/faltante), 403 (plan vencido o endpoint no incluido en tu plan), 404 (sin resultados), 429 (limite diario o cupo del plan alcanzado), 500/502 (error al consultar al SRI).