Method: googleapis.cloudresourcemanager.v1.projects.list

Lists Projects that the caller has theresourcemanager.projects.getpermission on and satisfy the specified filter. This method returnsProjects in an unspecified order. This method is eventually consistentwith project mutations; this means that a newly created project may notappear in the results or recent updates to an existing project may notbe reflected in the results. To retrieve the latest state of a project,use the GetProject method. NOTE: If the request filter contains aparent.type andparent.id and the caller has theresourcemanager.projects.list permission on the parent, the resultswill be drawn from an alternate index which provides more consistentresults. In future versions of this API, this List method will be splitinto List and Search to properly capture the behavioral difference.

Arguments

Parameters
filter

string

Optional. An expression for filtering the results of the request. Filter rules are case insensitive. If multiple fields are included in a filter query, the query will return results that match any of the fields. Some eligible fields for filtering are: +name +id +labels. (wherekey is the name of a label) +parent.type +parent.id +lifecycleState Some examples of filter queries: | Query | Description | |------------------|-----------------------------------------------------| | name:how | The project's name starts with "how". | | name:Howl | The project's name isHowl orhowl. | | name:HOWL | Equivalent to above. | | NAME:howl | Equivalent to above. | | labels.color: | The project has the labelcolor. | | labels.color:red | The project's labelcolor has the valuered. | | labels.color:red labels.size:big | The project's labelcolor has the valuered and its labelsize has the valuebig.| | lifecycleState:DELETE_REQUESTED | Only show projects that are pending deletion.| If no filter is specified, the call will return projects for which the user has theresourcemanager.projects.get permission. NOTE: To perform a by-parent query (eg., what projects are directly in a Folder), the caller must have theresourcemanager.projects.list permission on the parent and the filter must contain both aparent.type and aparent.id restriction (example: "parent.type:folder parent.id:123"). In this case an alternate search index is used which provides more consistent results.

pageSize

integer (int32 format)

Optional. The maximum number of Projects to return in the response. The server can return fewer Projects than requested. If unspecified, server picks an appropriate default.

pageToken

string

Optional. A pagination token returned from a previous call to ListProjects that indicates from where listing should continue.

Raised exceptions

Exceptions
ConnectionErrorIn case of a network problem (such as DNS failure or refused connection).
HttpErrorIf the response status is >= 400 (excluding 429 and 503).
TimeoutErrorIf a long-running operation takes longer to finish than the specified timeout limit.
TypeErrorIf an operation or function receives an argument of the wrong type.
ValueErrorIf an operation or function receives an argument of the right type but an inappropriate value. For example, a negative timeout.

Response

If successful, the response contains an instance ofListProjectsResponse.

Subworkflow snippet

Some fields might be optional or required.To identify required fields, refer to theAPI documentation.

YAML

-list:call:googleapis.cloudresourcemanager.v1.projects.listargs:filter:...pageSize:...pageToken:...result:listResult

JSON

[{"list":{"call":"googleapis.cloudresourcemanager.v1.projects.list","args":{"filter":"...","pageSize":"...","pageToken":"..."},"result":"listResult"}}]

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2026-02-19 UTC.