> ## 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 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…`) | | 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 ## OpenAPI ````yaml /api-reference/openapi.json get /v1/agents/runs openapi: 3.1.0 info: title: Skyvern API description: API for Skyvern version: 1.0.0 servers: - url: https://api.skyvern.com x-fern-server-name: Cloud - url: https://api-staging.skyvern.com x-fern-server-name: Staging - url: http://localhost:8000 x-fern-server-name: Local security: [] paths: /v1/agents/runs: get: tags: - Runs summary: Get all runs description: >- 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 operationId: get_workflow_runs_v1_workflows_runs_get parameters: - name: page in: query required: false schema: type: integer minimum: 1 description: Page number for pagination. default: 1 title: Page description: Page number for pagination. - name: page_size in: query required: false schema: type: integer minimum: 1 description: Number of runs to return per page. default: 10 title: Page Size description: Number of runs to return per page. - name: status in: query required: false schema: anyOf: - type: array items: $ref: '#/components/schemas/WorkflowRunStatus' - type: 'null' description: Filter by one or more run statuses. title: Status description: Filter by one or more run statuses. - name: search_key in: query required: false schema: anyOf: - type: string maxLength: 500 - type: 'null' description: >- 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. examples: - login_url - credential_value - wr_abc123 title: Search Key description: >- 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. - name: error_code in: query required: false schema: anyOf: - type: string maxLength: 500 - type: 'null' description: >- 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. examples: - INVALID_CREDENTIALS - LOGIN_FAILED - CAPTCHA_DETECTED title: Error Code description: >- 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. - name: x-api-key in: header required: false schema: anyOf: - type: string - type: 'null' description: >- Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings. title: X-Api-Key description: >- Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings. responses: '200': description: Successful Response content: application/json: schema: type: array items: $ref: '#/components/schemas/WorkflowRun' title: Response Get Workflow Runs V1 Workflows Runs Get '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' components: schemas: WorkflowRunStatus: type: string enum: - created - queued - running - failed - terminated - canceled - timed_out - completed - paused title: WorkflowRunStatus WorkflowRun: properties: workflow_run_id: type: string title: Workflow Run Id workflow_id: type: string title: Workflow Id workflow_permanent_id: type: string title: Workflow Permanent Id organization_id: type: string title: Organization Id browser_session_id: anyOf: - type: string - type: 'null' title: Browser Session Id browser_profile_id: anyOf: - type: string - type: 'null' title: Browser Profile Id debug_session_id: anyOf: - type: string - type: 'null' title: Debug Session Id status: $ref: '#/components/schemas/WorkflowRunStatus' extra_http_headers: anyOf: - additionalProperties: type: string type: object - type: 'null' title: Extra Http Headers cdp_connect_headers: anyOf: - additionalProperties: type: string type: object - type: 'null' title: Cdp Connect Headers proxy_location: anyOf: - $ref: '#/components/schemas/ProxyLocation' - $ref: '#/components/schemas/GeoTarget' - additionalProperties: true type: object - type: 'null' title: Proxy Location webhook_callback_url: anyOf: - type: string - type: 'null' title: Webhook Callback Url webhook_failure_reason: anyOf: - type: string - type: 'null' title: Webhook Failure Reason totp_verification_url: anyOf: - type: string - type: 'null' title: Totp Verification Url totp_identifier: anyOf: - type: string - type: 'null' title: Totp Identifier failure_reason: anyOf: - type: string - type: 'null' title: Failure Reason failure_category: anyOf: - items: additionalProperties: true type: object type: array - type: 'null' title: Failure Category parent_workflow_run_id: anyOf: - type: string - type: 'null' title: Parent Workflow Run Id workflow_title: anyOf: - type: string - type: 'null' title: Workflow Title max_screenshot_scrolls: anyOf: - type: integer - type: 'null' title: Max Screenshot Scrolls max_elapsed_time_minutes: anyOf: - type: integer - type: 'null' title: Max Elapsed Time Minutes browser_address: anyOf: - type: string - type: 'null' title: Browser Address run_with: anyOf: - type: string - type: 'null' title: Run With script_run: anyOf: - $ref: '#/components/schemas/ScriptRunResponse' - type: 'null' job_id: anyOf: - type: string - type: 'null' title: Job Id depends_on_workflow_run_id: anyOf: - type: string - type: 'null' title: Depends On Workflow Run Id sequential_key: anyOf: - type: string - type: 'null' title: Sequential Key ai_fallback: anyOf: - type: boolean - type: 'null' title: Ai Fallback code_gen: anyOf: - type: boolean - type: 'null' title: Code Gen trigger_type: anyOf: - $ref: '#/components/schemas/WorkflowRunTriggerType' - type: 'null' workflow_schedule_id: anyOf: - type: string - type: 'null' title: Workflow Schedule Id ignore_inherited_workflow_system_prompt: type: boolean title: Ignore Inherited Workflow System Prompt default: false copilot_session_id: anyOf: - type: string - type: 'null' title: Copilot Session Id credits_used: type: integer title: Credits Used default: 0 cached_credits_used: type: integer title: Cached Credits Used default: 0 queued_at: anyOf: - type: string format: date-time - type: 'null' title: Queued At started_at: anyOf: - type: string format: date-time - type: 'null' title: Started At finished_at: anyOf: - type: string format: date-time - type: 'null' title: Finished At created_at: type: string format: date-time title: Created At modified_at: type: string format: date-time title: Modified At type: object required: - workflow_run_id - workflow_id - workflow_permanent_id - organization_id - status - created_at - modified_at title: WorkflowRun HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError ProxyLocation: type: string enum: - 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 title: ProxyLocation GeoTarget: properties: country: type: string maxLength: 2 minLength: 2 title: Country description: ISO 3166-1 alpha-2 country code (e.g., 'US', 'GB', 'DE') examples: - US - GB - DE - FR subdivision: anyOf: - type: string maxLength: 10 - type: 'null' title: Subdivision description: >- ISO 3166-2 subdivision code without country prefix (e.g., 'CA' for California, 'NY' for New York) examples: - CA - NY - TX - ENG city: anyOf: - type: string maxLength: 100 - type: 'null' title: City description: >- City name in English from GeoNames (e.g., 'New York', 'Los Angeles', 'London') examples: - New York - Los Angeles - London - Berlin type: object required: - country title: GeoTarget description: >- Granular proxy geo-targeting request with country, optional subdivision, and optional city. ScriptRunResponse: properties: ai_fallback_triggered: type: boolean title: Ai Fallback Triggered default: false script_id: anyOf: - type: string - type: 'null' title: Script Id script_revision_id: anyOf: - type: string - type: 'null' title: Script Revision Id type: object title: ScriptRunResponse WorkflowRunTriggerType: type: string enum: - manual - api - scheduled - webhook title: WorkflowRunTriggerType description: |- How a workflow run was initiated. - manual: User clicked "Run" in the UI - api: Direct API call to the run endpoint - scheduled: Triggered by a cron schedule - webhook: Triggered by an external system via the webhook endpoint ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError ````