> ## Documentation Index
> Fetch the complete documentation index at: https://docs.automate.ax/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Automate.ax automations are TypeScript programs.
> Use Bun for installation and command examples.
> Use Automate.ax for the product name and automate.ax for the package, CLI, and domain.
> Treat documented public APIs as current; do not invent transitional or deprecated names.

# List Actor runs

> Lists Apify Actor runs with resource, status, and time filters.

`apify.listRuns` lists Apify Actor runs with resource, status, and time filters.

## Example

```ts automations/apify-list-runs.automation.ts theme={null}
import { automation, onHttpRequest } from "automate.ax"
import { apify } from "automate.ax/apify"

export default automation("List Actor runs", () => {
  onHttpRequest({ scope: "automation" })

  apify.listRuns({
    actorId: "apify/web-scraper",
    status: ["SUCCEEDED", "FAILED"],
    desc: true,
    limit: 100,
  })
})
```

## Inputs

Pass at most one of `actorId` or `taskId`. Omit both to list account-wide runs.

| Field           | Type                                 | Default          | Description                         |
| --------------- | ------------------------------------ | ---------------- | ----------------------------------- |
| `actorId`       | `string`                             | —                | Limit to one Actor.                 |
| `taskId`        | `string`                             | —                | Limit to one saved task.            |
| `status`        | `ApifyJobStatus \| ApifyJobStatus[]` | —                | Filter by one or more statuses.     |
| `startedAfter`  | ISO 8601 string                      | —                | Only runs started after this time.  |
| `startedBefore` | ISO 8601 string                      | —                | Only runs started before this time. |
| `desc`          | `boolean`                            | Provider default | Return newest runs first.           |
| `limit`         | `number`                             | Provider default | Page size from 1 to 1000.           |
| `offset`        | `number`                             | `0`              | Runs to skip.                       |

## Output

Returns `items` plus `count`, `total`, `limit`, `offset`, and `desc` pagination metadata.

Statuses include `READY`, `RUNNING`, `SUCCEEDED`, `FAILED`, `TIMING-OUT`, `TIMED-OUT`, `ABORTING`, and `ABORTED`.