Get all runs
Changed onList 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…) |
| workflow_permanent_id | The permanent ID of the workflow that ran (e.g. wpid_123…) |
| Workflow title | The title of the workflow that ran |
| 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) |
| webhook_callback_url | The webhook URL the run posts its result to |
Soft-deleted parameter definitions are excluded from key/description matching. A run is returned if any of the fields above contain the search term.
A complete identifier also matches the run that used it, by exact equality:
| Identifier | Description |
|---|---|
| browser_profile_id | The browser profile the run used (e.g. bp_123…) |
| browser_session_id | The browser session the run used (e.g. pbs_123…) |
| Credential id | A credential the run used (e.g. cred_123…) |
| workflow_run_id | The run itself (e.g. wr_123…) |
| Task id | The workflow run the task ran in, when that run is top-level (e.g. tsk_123…) |
A complete browser profile, browser session, workflow run or task id is matched against those identifiers only, not the text fields above. A credential id matches a run when it is the run's sequential credential, the credential the run selected from a pool or fell back to, or the credential bound by a credential parameter on the run's workflow version when the run was created and the run recorded no selection for that parameter. Other pool and fallback members the run did not use do not match.
Default search window
A search_key other than a complete browser profile, browser session, workflow run or task id is matched only against runs created in the 30 days before created_at_end (or before now) unless the request supplies created_at_start. This includes complete credential ids. Supply created_at_start (and optionally created_at_end) to search a different range. Explicit bounds apply to every search, complete ids included. Listings without search_key are not windowed. To fetch one run by its id, use GET /v1/runs/{run_id}.
created_at_start / created_at_end
Optional ISO 8601 bounds on the run's creation time: created_at_start is inclusive and created_at_end is exclusive. A timestamp without an offset is read as UTC.
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 (searched over the last 30 days)
- ?search_key=prod_credential&created_at_start=2026-01-01T00:00:00Z&created_at_end=2026-02-01T00:00:00Z — search one explicit month
Request
- Base URLhttps://api.skyvern.com
- AuthAPI key in header x-api-key
- TypeScriptA function with typed inputs. Its response is checked against the schema.
Query parameters
Page number for pagination.
Number of runs to return per page.
Filter by one or more run statuses.
Case-insensitive substring search across: workflow run ID, parameter key, parameter description, run parameter value, extra HTTP headers and webhook callback URL. A run is returned if any of these fields match. Soft-deleted parameter definitions are excluded from key/description matching. A complete browser profile ID, browser session ID or credential ID matches the run that used it exactly (no substring match). A complete workflow run ID matches that run. A complete task ID matches the workflow run the task ran in, when this list includes that run, or the standalone task itself where standalone tasks are listed. A complete browser profile, browser session, workflow run or task ID is matched against those identifiers only, not the text fields. A credential ID matches when it is the run's sequential credential, the credential the run selected from a pool or fell back to, or the credential bound by a credential parameter on the run's workflow version when the run was created and the run recorded no selection for it. The workflow title and workflow permanent ID are matched as well. Without created_at_start, a search other than a complete browser profile, browser session, workflow run or task ID covers only runs created in the 30 days before created_at_end (or before now).
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.
Only include runs created at or after this timestamp (ISO 8601; a value without an offset is read as UTC). Supplying it replaces the 30-day default window of a free-text search_key.
Only include runs created strictly before this timestamp (ISO 8601; a value without an offset is read as UTC). Without created_at_start, a free-text search_key covers the 30 days before this timestamp.
Response
Successful Response
Example response
[
{
"proxy_location": {
"country": "US",
"subdivision": "CA",
"city": "New York"
},
"browser_settings": {
"timezone_id": "America/New_York"
}
}
]Changes
- warning
for the
queryrequest parameterpage, the max was set to1000000.00 - warning
for the
queryrequest parameterpage_size, the max was set to1000.00
- warning
- warning
added the new
seo_recipe_submitenum value to the//response property for the response status
- warning