Skip to main content
List all runs across tasks and workflows for the current organization, with filtering and pagination. 
runs = await client.get_runs_v2(page=1, page_size=20, status="completed")
for run in runs:
    print(run.run_id, run.status)

​
Parameters

ParameterTypeRequiredDescription
pageintNoPage number (1-indexed).
page_sizeintNoResults per page.
statusRunStatus | list[RunStatus]NoFilter by run status.
search_keystrNoCase-insensitive substring search (min 3 chars).
request_optionsRequestOptionsNoPer-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). 
from skyvern.client.core import RequestOptions

request_options=RequestOptions(
    timeout_in_seconds=120,
    max_retries=3,
    additional_headers={"x-custom-header": "value"},
)
Option (Python)Option (TypeScript)TypeDescription
timeout_in_secondstimeoutInSecondsint / numberHTTP timeout in seconds.
max_retriesmaxRetriesint / numberRetry count.
additional_headersheadersdict / Record<string, string>Extra headers.
additional_query_parameters-dictExtra query parameters.
additional_body_parameters-dictExtra body parameters.
-abortSignalAbortSignalSignal to cancel the request.
-apiKeystringOverride API key.