Historial
Consulta las ejecuciones de una automatización recurrente.
Descripción general
Este endpoint devuelve el historial paginado de una automatización recurrente: una fila por cada ejecución, automática o manual, de la más reciente a la más antigua. Cada fila indica la fecha programada, la fecha en que se ejecutó, quién la ejecutó, si tuvo éxito y la orden de cobro que generó. El tamaño de página es fijo en 20 resultados.
Las ejecuciones con estatus error se pueden reintentar con Reintentar ejecución.
Requiere el permiso Leer en Automatizaciones.
Endpoint
https://app.credonix.mx/api/v1/recurring-automations/{automationId}/historyPath param: automationId — el id de la automatización recurrente.
Consulta el historial
La fila del ejemplo es una generación manual hecha con una API key: cobró la fecha programada 2026-10-14 el 2026-09-14 y generó la orden de cobro generated_invoice_id, que puedes consultar con Consultar orden de cobro.
Query params
| Parámetro | Tipo | Requerido | Default | Descripción |
|---|---|---|---|---|
page | integer ≥ 1 | No | 1 | Página solicitada. El tamaño de página es fijo en 20. |
Forma de las respuestas
| Campo | Tipo | Descripción |
|---|---|---|
id | string | ID de la ejecución. Es el historyId para reintentarla. |
automation | objeto | type e id de la automatización. |
milestone_id | string | null | Hito cobrado. Siempre null en automatizaciones recurrentes. |
scheduled_date | string | null | Fecha programada que se cobró (YYYY-MM-DD). |
executed_date | string | Fecha en que se ejecutó (YYYY-MM-DD). |
execution_type | string | automated o manual. |
status | string | success, error o partially_executed. |
generated_invoice_id | string | null | Orden de cobro generada. |
executed_by | objeto | Quién la ejecutó: { "type": "api_key", "name": "<nombre de la API key>" }, { "type": "user", "name": "..." } o { "type": "automation", "name": "..." } para las ejecuciones automáticas. |
created_at, updated_at | string (fecha) | Marcas de tiempo. |
Errores
| Status | Código | Causa |
|---|---|---|
400 | INVALID_PAGE | page no es un número entero entre 1 y 107374183. |
403 | INSUFFICIENT_PERMISSIONS | La API key no tiene el permiso Leer en Automatizaciones. |
404 | NOT_FOUND | La automatización recurrente no existe en tu organización. La respuesta incluye { "message": "La automatización no fue encontrada." }. |