The parent of the collection of Builds. Format: projects/{project}/locations/{location}
Query parameters
Parameters
projectId
string
Required. ID of the project.
Authorization requires the following IAM permission on the specified resource projectId:
cloudbuild.builds.list
pageSize
integer
Number of results to return in the list.
pageToken
string
The page token for the next page of Builds.
If unspecified, the first page of results is returned.
If the token is rejected for any reason, INVALID_ARGUMENT will be thrown. In this case, the token should be discarded, and pagination should be restarted from the first page of results.
[[["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-07-17 UTC."],[[["\u003cp\u003eThis endpoint retrieves a list of previously requested builds, which may be in progress, completed successfully, or completed unsuccessfully.\u003c/p\u003e\n"],["\u003cp\u003eThe HTTP request uses a GET method with a URL that employs gRPC Transcoding syntax and requires specifying the parent in the format \u003ccode\u003eprojects/{project}/locations/{location}\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe request supports several query parameters, including \u003ccode\u003eprojectId\u003c/code\u003e (required), \u003ccode\u003epageSize\u003c/code\u003e, \u003ccode\u003epageToken\u003c/code\u003e, and \u003ccode\u003efilter\u003c/code\u003e, to customize the list of builds that is retrieved.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must be empty, and a successful response will contain an instance of \u003ccode\u003eListBuildsResponse\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization for this endpoint requires the \u003ccode\u003ecloudbuild.builds.list\u003c/code\u003e IAM permission on the specified \u003ccode\u003eprojectId\u003c/code\u003e and the \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],[],null,["# Method: projects.locations.builds.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- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists previously requested builds.\n\nPreviously requested builds may still be in-progress, or may have finished successfully or unsuccessfully.\n\n### HTTP request\n\n`GET https://cloudbuild.googleapis.com/v1/{parent=projects/*/locations/*}/builds`\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\nIf successful, the response body contains an instance of [ListBuildsResponse](/build/docs/api/reference/rest/v1/ListBuildsResponse).\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/)."]]