Get all 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…) |
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
Authorizations
Your Skyvern API key from https://app.skyvern.com/settings.
Query Parameters
Page number for pagination.
1 <= x <= 1000000Number of runs to return per page.
1 <= x <= 1000Filter by one or more run statuses.
created, queued, running, failed, terminated, canceled, timed_out, completed, paused 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).
500"login_url"
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.
500"INVALID_CREDENTIALS"
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.
"2026-01-01T00:00:00Z"
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.
"2026-02-01T00:00:00Z"
Response
Successful Response
created, queued, running, failed, terminated, canceled, timed_out, completed, paused Which layer of the seed-precedence chain seeded a run's browser (provenance).
Resolved at run setup, before any browser creation, for all run types (C-semantics). A serialized Save & Reuse run re-resolves once more after the sequential wait, so a profile an earlier run in its lane saved while it was queued becomes own_memory rather than a stale pick.
- override: explicit request browser_profile_id (one-run-only pick via API)
- picked: the workflow's explicit profile pick (workflows.browser_profile_id) — "always start here"
- own_memory: the workflow's own auto-profile (no pick + persist_browser_session)
- credential: the run's selected credential's profile (rotation-aware; also the empty-own boot)
- fresh: no seed profile
- degraded_fresh: a resolved profile failed to load; ran fresh
override, picked, own_memory, credential, fresh, degraded_fresh One-based number of the current workflow run attempt
Whether another attempt is scheduled for this workflow run
Timestamp when the next workflow run attempt is scheduled
Attempts recorded for this workflow run
RESIDENTIAL, US-CA, US-NY, US-TX, US-FL, US-WA, RESIDENTIAL_ES, RESIDENTIAL_IE, RESIDENTIAL_GB, RESIDENTIAL_IN, RESIDENTIAL_JP, RESIDENTIAL_FR, RESIDENTIAL_DE, RESIDENTIAL_NZ, RESIDENTIAL_ZA, RESIDENTIAL_AR, RESIDENTIAL_AU, RESIDENTIAL_BR, RESIDENTIAL_TR, RESIDENTIAL_CA, RESIDENTIAL_MX, RESIDENTIAL_IT, RESIDENTIAL_NL, RESIDENTIAL_PH, RESIDENTIAL_KR, RESIDENTIAL_SA, RESIDENTIAL_ISP, NONE Browser settings copied from the workflow version when the run was created
How a workflow run was initiated.
- manual: User clicked "Run" in the UI
- mcp: First-party MCP client or Skyvern CLI request
- api: Direct API call to the run endpoint
- scheduled: Triggered by a cron schedule
- webhook: Triggered by an external system via the webhook endpoint
- event: Triggered by an external event source
- job_recipe_extract: Launched by a job recipe extract request
- job_recipe_apply: Launched by a job recipe apply request
- seo_recipe_submit: Launched by an SEO recipe directory submission
manual, mcp, api, scheduled, webhook, event, job_recipe_extract, job_recipe_apply, seo_recipe_submit ID of the user who started the run

