List workflow runs

List workflow runs across all workflows for the current organization.

Results are paginated and can be filtered by status, search_key, and error_code. All filters are combined with AND logic — a run must match every supplied filter to be returned.

search_key

A case-insensitive substring search that matches against any of the following fields:

Searched field	Description
`workflow_run_id`	The unique run identifier (e.g. `wr_123…`)
Parameter key	The `key` of any workflow parameter definition associated with the run
Parameter description	The `description` of any workflow parameter definition
Run parameter value	The actual value supplied for any parameter when the run was created
`extra_http_headers`	Extra HTTP headers attached to the run (searched as raw JSON text)

Soft-deleted parameter definitions are excluded from key/description matching. A run is returned if any of the fields above contain the search term.

error_code

An exact-match filter against the error_code field inside each task’s errors JSON array. A run matches if any of its tasks contains an error object with a matching error_code value. Error codes are user-defined strings set during workflow execution (e.g. INVALID_CREDENTIALS, LOGIN_FAILED, CAPTCHA_DETECTED).

Combining filters

All query parameters use AND logic:

?status=failed — only failed runs
?status=failed&error_code=LOGIN_FAILED — failed runs and have a LOGIN_FAILED error
?status=failed&error_code=LOGIN_FAILED&search_key=prod_credential — all three conditions must match

List workflow runs across all workflows for the current organization. Results are paginated and can be filtered by **status**, **search_key**, and **error_code**. All filters are combined with **AND** logic — a run must match every supplied filter to be returned. ### search_key A case-insensitive substring search that matches against **any** of the following fields: | Searched field | Description | |---|---| | `workflow_run_id` | The unique run identifier (e.g. `wr_123…`) | | Parameter **key** | The `key` of any workflow parameter definition associated with the run | | Parameter **description** | The `description` of any workflow parameter definition | | Run parameter **value** | The actual value supplied for any parameter when the run was created | | `extra_http_headers` | Extra HTTP headers attached to the run (searched as raw JSON text) | Soft-deleted parameter definitions are excluded from key/description matching. A run is returned if **any** of the fields above contain the search term. ### error_code An **exact-match** filter against the `error_code` field inside each task's `errors` JSON array. A run matches if **any** of its tasks contains an error object with a matching `error_code` value. Error codes are user-defined strings set during workflow execution (e.g. `INVALID_CREDENTIALS`, `LOGIN_FAILED`, `CAPTCHA_DETECTED`). ### Combining filters All query parameters use AND logic: - `?status=failed` — only failed runs - `?status=failed&error_code=LOGIN_FAILED` — failed runs **and** have a LOGIN_FAILED error - `?status=failed&error_code=LOGIN_FAILED&search_key=prod_credential` — all three conditions must match

Query parameters

pageintegerOptional>=1Defaults to 1

Page number for pagination.

page_sizeintegerOptional>=1Defaults to 10

Number of runs to return per page.

statuslist of enums or nullOptional

Filter by one or more run statuses.

search_keystring or nullOptional<=500 characters

Case-insensitive substring search across: workflow run ID, parameter key, parameter description, run parameter value, and extra HTTP headers. A run is returned if any of these fields match. Soft-deleted parameter definitions are excluded from key/description matching.

error_codestring or nullOptional<=500 characters

Exact-match filter on the error_code field inside each task’s errors JSON array. A run matches if any of its tasks contains an error with a matching error_code. Error codes are user-defined strings set during workflow execution.

Response

Successful Response

workflow_run_idstring

workflow_idstring

workflow_permanent_idstring

organization_idstring

statusenum

created_atstringformat: "date-time"

modified_atstringformat: "date-time"

browser_session_idstring or null

browser_profile_idstring or null

debug_session_idstring or null

extra_http_headersmap from strings to strings or null

proxy_locationenum or object or map from strings to any or null

webhook_callback_urlstring or null

webhook_failure_reasonstring or null

totp_verification_urlstring or null

totp_identifierstring or null

failure_reasonstring or null

parent_workflow_run_idstring or null

workflow_titlestring or null

max_screenshot_scrollsinteger or null

browser_addressstring or null

run_withstring or null

script_runobject or null

job_idstring or null

depends_on_workflow_run_idstring or null

sequential_keystring or null

ai_fallbackboolean or null

code_genboolean or null

waiting_for_verification_codeboolean or nullDefaults to false

verification_code_identifierstring or null

verification_code_polling_started_atstring or nullformat: "date-time"

queued_atstring or nullformat: "date-time"

started_atstring or nullformat: "date-time"

finished_atstring or nullformat: "date-time"

Errors

List workflow runs across all workflows for the current organization.

Results are paginated and can be filtered by status, search_key, and error_code. All filters are combined with AND logic — a run must match every supplied filter to be returned.

search_key

A case-insensitive substring search that matches against any of the following fields:

Searched field	Description
`workflow_run_id`	The unique run identifier (e.g. `wr_123…`)
Parameter key	The `key` of any workflow parameter definition associated with the run
Parameter description	The `description` of any workflow parameter definition
Run parameter value	The actual value supplied for any parameter when the run was created
`extra_http_headers`	Extra HTTP headers attached to the run (searched as raw JSON text)

Soft-deleted parameter definitions are excluded from key/description matching. A run is returned if any of the fields above contain the search term.

error_code

Combining filters

All query parameters use AND logic:

?status=failed — only failed runs
?status=failed&error_code=LOGIN_FAILED — failed runs and have a LOGIN_FAILED error
?status=failed&error_code=LOGIN_FAILED&search_key=prod_credential — all three conditions must match

1	import { SkyvernClient } from "@skyvern/client";
2
3	async function main() {
4	const client = new SkyvernClient();
5	await client.getWorkflowRuns({});
6	}
7	main();

1	[
2	{
3	"workflow_run_id": "string",
4	"workflow_id": "string",
5	"workflow_permanent_id": "string",
6	"organization_id": "string",
7	"status": "created",
8	"created_at": "2024-01-15T09:30:00Z",
9	"modified_at": "2024-01-15T09:30:00Z",
10	"browser_session_id": "string",
11	"browser_profile_id": "string",
12	"debug_session_id": "string",
13	"extra_http_headers": {},
14	"proxy_location": {},
15	"webhook_callback_url": "string",
16	"webhook_failure_reason": "string",
17	"totp_verification_url": "string",
18	"totp_identifier": "string",
19	"failure_reason": "string",
20	"parent_workflow_run_id": "string",
21	"workflow_title": "string",
22	"max_screenshot_scrolls": 1,
23	"browser_address": "string",
24	"run_with": "string",
25	"script_run": {
26	"ai_fallback_triggered": false
27	},
28	"job_id": "string",
29	"depends_on_workflow_run_id": "string",
30	"sequential_key": "string",
31	"ai_fallback": true,
32	"code_gen": true,
33	"waiting_for_verification_code": false,
34	"verification_code_identifier": "string",
35	"verification_code_polling_started_at": "2024-01-15T09:30:00Z",
36	"queued_at": "2024-01-15T09:30:00Z",
37	"started_at": "2024-01-15T09:30:00Z",
38	"finished_at": "2024-01-15T09:30:00Z"
39	}
40	]

search_key

error_code

Combining filters

Headers

Query parameters

Response

Errors

search_key

error_code

Combining filters