Stay organized with collections
Save and categorize content based on your preferences.
Returns a list of executions which belong to the workflow with the given
name. The method returns executions of all workflow revisions. Returned
executions are ordered by their start time (newest first).
Arguments
Parameters
parent
string
Required. Name of the workflow for which the executions should be listed. Format: projects/{project}/locations/{location}/workflows/{workflow}
filter
string
Optional. Filters applied to the [Executions.ListExecutions] results. The following fields are supported for filtering: executionId, state, createTime, startTime, endTime, duration, workflowRevisionId, stepName, label, and disableConcurrencyQuotaOverflowBuffering. For details, see AIP-160. For more information, see Filter executions. For example, if you are using the Google APIs Explorer: state="SUCCEEDED" or startTime>"2023-08-01" AND state="FAILED"
orderBy
string
Optional. Comma-separated list of fields that specify the ordering applied to the [Executions.ListExecutions] results. By default the ordering is based on descending createTime. The following fields are supported for ordering: executionId, state, createTime, startTime, endTime, duration, and workflowRevisionId. For details, see AIP-132.
Maximum number of executions to return per call. Max supported value depends on the selected Execution view: it's 1000 for BASIC and 100 for FULL. The default value used if the field is not specified is 100, regardless of the selected view. Values greater than the max value will be coerced down to it.
pageToken
string
A page token, received from a previous ListExecutions call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to ListExecutions must match the call that provided the page token. Note that pagination is applied to dynamic data. The list of executions returned can change between page requests.
view
enum
Optional. A view defining which fields should be filled in the returned executions. The API will default to the BASIC view.
Enum type. Can be one of the following:
EXECUTION_VIEW_UNSPECIFIED
The default / unset value.
BASIC
Includes only basic metadata about the execution. The following fields are returned: name, start_time, end_time, duration, state, and workflow_revision_id.
FULL
Includes all data.
Raised exceptions
Exceptions
ConnectionError
In case of a network problem (such as DNS failure or refused connection).
HttpError
If the response status is >= 400 (excluding 429 and 503).
TimeoutError
If a long-running operation takes longer to finish than the specified timeout limit.
TypeError
If an operation or function receives an argument of the wrong type.
ValueError
If an operation or function receives an argument of the right type but an inappropriate value. For example, a negative timeout.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-04 UTC."],[],[],null,["# Method: googleapis.workflowexecutions.v1.projects.locations.workflows.executions.list\n\nReturns a list of executions which belong to the workflow with the given\nname. The method returns executions of all workflow revisions. Returned\nexecutions are ordered by their start time (newest first).\n\nArguments\n---------\n\nRaised exceptions\n-----------------\n\nResponse\n--------\n\nIf successful, the response contains an instance of [`ListExecutionsResponse`](/workflows/docs/reference/googleapis/workflowexecutions/v1/Overview#ListExecutionsResponse).\n\nSubworkflow snippet\n-------------------\n\nSome fields might be optional or required.\nTo identify required fields, refer to the [API documentation](https://cloud.google.com/workflows/docs/reference/executions/rest/v1/projects.locations.workflows.executions/list). \n\n### YAML\n\n```yaml\n- list:\n call: googleapis.workflowexecutions.v1.projects.locations.workflows.executions.list\n args:\n parent: ...\n pageSize: ...\n pageToken: ...\n view: ...\n result: listResult\n```\n\n### JSON\n\n```json\n[\n {\n \"list\": {\n \"call\": \"googleapis.workflowexecutions.v1.projects.locations.workflows.executions.list\",\n \"args\": {\n \"parent\": \"...\",\n \"pageSize\": \"...\",\n \"pageToken\": \"...\",\n \"view\": \"...\"\n },\n \"result\": \"listResult\"\n }\n }\n]\n```"]]