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

# get_runs_v2

List all runs across tasks and agents for the current organization, with filtering and pagination.

<CodeGroup>
  ```python Python theme={null}
  runs = await client.get_runs_v2(page=1, page_size=20, status="completed")
  for run in runs:
      print(run.run_id, run.status)
  ```

  ```typescript TypeScript theme={null}
  const runs = await skyvern.getRunsV2({ page: 1, page_size: 20, status: "completed" });
  for (const run of runs) {
    console.log(run.run_id, run.status);
  }
  ```
</CodeGroup>

### Parameters

| Parameter         | Type                           | Required | Description                                      |
| ----------------- | ------------------------------ | -------- | ------------------------------------------------ |
| `page`            | `int`                          | No       | Page number (1-indexed).                         |
| `page_size`       | `int`                          | No       | Results per page.                                |
| `status`          | `RunStatus \| list[RunStatus]` | No       | Filter by run status.                            |
| `search_key`      | `str`                          | No       | Case-insensitive substring search (min 3 chars). |
| `request_options` | `RequestOptions`               | No       | Per-request configuration (see below).           |

### Returns `list[TaskRunListItem]`

***

### Request options

Override timeout, retries, or headers for this call by passing `request_options` (Python) or a second options argument (TypeScript).

<CodeGroup>
  ```python Python theme={null}
  from skyvern.client.core import RequestOptions

  request_options=RequestOptions(
      timeout_in_seconds=120,
      max_retries=3,
      additional_headers={"x-custom-header": "value"},
  )
  ```

  ```typescript TypeScript theme={null}
  // Pass as second argument to any method
  {
    timeoutInSeconds: 120,
    maxRetries: 3,
    headers: { "x-custom-header": "value" },
  }
  ```
</CodeGroup>

| Option (Python)               | Option (TypeScript) | Type                              | Description                   |
| ----------------------------- | ------------------- | --------------------------------- | ----------------------------- |
| `timeout_in_seconds`          | `timeoutInSeconds`  | `int` / `number`                  | HTTP timeout in seconds.      |
| `max_retries`                 | `maxRetries`        | `int` / `number`                  | Retry count.                  |
| `additional_headers`          | `headers`           | `dict` / `Record<string, string>` | Extra headers.                |
| `additional_query_parameters` | -                   | `dict`                            | Extra query parameters.       |
| `additional_body_parameters`  | -                   | `dict`                            | Extra body parameters.        |
| -                             | `abortSignal`       | `AbortSignal`                     | Signal to cancel the request. |
| -                             | `apiKey`            | `string`                          | Override API key.             |

***