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).
HTTP request
GET https://workflowexecutions.googleapis.com/v1/{parent=projects/*/locations/*/workflows/*}/executions
Required. Name of the workflow for which the executions should be listed. Format: projects/{project}/locations/{location}/workflows/{workflow}
Authorization requires the following IAM permission on the specified resource parent:
workflows.executions.list
Query parameters
Parameters
pageSize
integer
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 executions.list call. Provide this to retrieve the subsequent page.
When paginating, all other parameters provided to executions.list 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.
Optional. A view defining which fields should be filled in the returned executions. The API will default to the BASIC view.
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.
[[["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-05-14 UTC."],[],[],null,["# Method: projects.locations.workflows.executions.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListExecutionsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nReturns 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).\n\n### HTTP request\n\n`GET https://workflowexecutions.googleapis.com/v1/{parent=projects/*/locations/*/workflows/*}/executions`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Query parameters\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse for the [executions.list](/workflows/docs/reference/executions/rest/v1/projects.locations.workflows.executions/list#google.cloud.workflows.executions.v1.Executions.ListExecutions) method.\n\nIf successful, the response body contains data with the following structure:\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n\nFor more information, see the [Authentication Overview](https://cloud.google.com/docs/authentication/)."]]