Paginacion y Filtro

Lista transacciones con paginación real y filtros (fechas, códigos de respuesta, tenant si aplica al alcance de la API Key).

Autenticación

Requiere X-Api-Key válida.

Paginación: número y tamaño de página con límites máximos definidos por el backend.

Filtros: rango de fechas (obligatorio o recomendado), códigos de respuesta, tipo de acción, otros criterios permitidos.

Colección de elementos resumidos (identificadores, importes, estado, códigos/textos de respuesta, marcas de tiempo, metadatos relevantes),

Metadatos de paginación: total de elementos, total de páginas, indicador de siguiente/anterior.

Paginación en rangos válidos; tamaño de página dentro de umbrales.

Rango de fechas coherente (inicio ≤ fin) y en zona horaria documentada.

400 Bad Request: paginación inválida, rango invertido o filtros incompatibles.

401 Unauthorized: API Key ausente/inválida.

500 Internal Server Error: error al consultar la fuente de datos o componer la página.

Notas: Evita cargas masivas: usa paginación para reportes operativos y dashboards.

Cuando un filtro reduce demasiado el conjunto (p. ej., fechas muy estrechas), la página puede quedar vacía; esto no es un error.