---
title: "List Automation run history"
description: "Traverse bounded Automation run history with the returned opaque cursor."
canonical: https://y2.dev/docs/api/reference/automations/listAutomationRuns/
---

Endpoint Reference[Automations](https://y2.dev/docs/api/reference/automations)

# List Automation run history

Traverse bounded Automation run history with the returned opaque cursor.

`GET https://api.y2.dev/api/v1/automations/{automationId}/runs`

- Operation ID: `listAutomationRuns`
- Required scopes: `automations:read`
- Contract: https://y2.dev/openapi.json

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `automationId` | path | string | Yes |  |
| `cursor` | query | string | No | Opaque continuation token from the previous response. Bound to the original filters and ordering. |
| `limit` | query | integer | No |  |

## Responses

| Status | Description | Body |
| --- | --- | --- |
| 200 | Bounded run history | `AutomationRunListResponse` |
| 400 | Invalid request parameters |  |
| 401 | Missing or invalid API key |  |
| 403 | Insufficient permissions or access denied |  |
| 404 | Resource not found |  |
| 429 | Rate limit exceeded (per-key or per-account aggregate) |  |
| 500 | Internal server error |  |

### 200 response fields

| Field | Type | Description |
| --- | --- | --- |
| `data[]` | array of `AutomationRun` |  |
| `data[].id` | string |  |
| `data[].type` | string |  |
| `data[].automationId` | string |  |
| `data[].projectId` | string or null |  |
| `data[].reportId` | string or null |  |
| `data[].triggerKind` | `manual`, `schedule`, `profile_report_completed` |  |
| `data[].status` | `queued`, `running`, `succeeded`, `failed`, `skipped`, `canceled` |  |
| `data[].definitionRevision` | integer |  |
| `data[].resultSummary` | string or null |  |
| `data[].model` | string or null |  |
| `data[].usage` | object |  |
| `data[].skipReason` | string or null |  |
| `data[].error` | null or object |  |
| `data[].scheduledFor` | string or null (date-time) |  |
| `data[].createdAt` | string (date-time) |  |
| `data[].startedAt` | string or null (date-time) |  |
| `data[].completedAt` | string or null (date-time) |  |
| `data[].links` | object |  |
| `meta` | `PublicListMeta` |  |
| `meta.count` | integer |  |
| `meta.pageCount` | integer |  |
| `meta.limit` | integer |  |
| `meta.isDone` | boolean |  |
| `meta.hasMore` | boolean |  |
| `meta.nextCursor` | string or null |  |
| `meta.asOf` | string (date-time) |  |
| `meta.page` | `PublicPageMeta` |  |
| `links` | `PublicCollectionLinks` |  |
| `links.self` | string |  |
| `links.next` | string or null |  |