Docs

GET /automations/{id}/runs

Every time this automation fired, newest first — the answer to "did it run?", which the engine used to throw away.

Parameters

  • id path · string · required
  • limit query · integer · optional
  • cursor query · string · optional
  • after query · string · optional
  • status query · "running" | "succeeded" | "failed" · optional

Responses

  • 200 Success
  • 400 Validation error
  • 401 Missing API key
  • 403 Forbidden
  • 404 Not found
  • 409 Conflict
  • 429 Rate limited
  • 500 Internal server error

Response headers

  • ratelimit-limit — Messages this API key may spend in one 60-second window.
  • ratelimit-remaining — Messages left in the current window.
  • ratelimit-reset — Seconds until the current window resets and the budget refills.

200 body

FieldTypeRequiredNotes
dataarray<object>yes
data[].automation_idstringyes
data[].contact_idstring | nullyes
data[].event_namestring | nullyes
data[].finished_atstring | nullyes
data[].idstringyes
data[].started_atstringyes
data[].status"running" | "succeeded" | "failed"yes
data[].stepsarray<object>no
data[].trigger_typestringyes
data[].version_numberinteger | nullyes
has_morebooleanyes
next_cursorstring | nullyes

Errors

Codes in the catalogue that answer with one of this operation’s error statuses. Every one of them carries a fix.