---
title: "List automation runs"
method: GET
path: "/automations/{automationId}/runs"
tags: ["Automations"]
---

# List automation runs

`GET /automations/{automationId}/runs`

## Request

- Base URL: `https://api.sazabi.com/v1`
- URL: `https://api.sazabi.com/v1/automations/{automationId}/runs`
- Auth: none declared

List runs for an automation, most recent first.

## Path parameters

- `automationId` string, uuid, required: Automation ID.

## Query parameters

- `projectId` string, uuid: Project that owns the automation. Auto-filled from CLI and SDK context when omitted.
- `status` union: Filter runs by status. Accepts a single status or an array of statuses (matched as OR).
  - 'running' | 'succeeded' | 'failed' | 'timed_out' | 'cancelled'
  - string[]
- `cursor` string: Cursor from a previous response's nextCursor to fetch the next page.
- `limit` integer: Maximum number of runs to return per page.

## Response `200`

OK

- object
  - `runs` object[], required
    - `id` string, uuid, required
    - `automationRunKey` string, required
    - `status` 'running' | 'succeeded' | 'failed' | 'timed_out' | 'cancelled', required
    - `startedAt` string, date-time, required
    - `completedAt` string, date-time, nullable, required
    - `durationMs` integer, nullable, required
    - `exitCode` integer, nullable, required
    - `scheduledAt` string, date-time, nullable, required: When the run was scheduled to start, if known.
    - `dueAt` string, date-time, nullable, required: When the run became due, if known.
    - `errorMessage` string, nullable, required: Failure detail for the run, if it failed or timed out.
  - `nextCursor` string, nullable, required: Pass as 'cursor' to fetch the next page. Null when there are no more results.
  - `recordedHistoryStartsAt` string, date-time, required: Earliest timestamp for which run history is recorded.

---

[API](https://skmtc.dev/sazabi/apis/sazabi-public-api.md) - [All operations](https://skmtc.dev/sazabi/apis/sazabi-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sazabi/apis/sazabi-public-api/revisions/965b6230cf45?raw)