Lists the folders that are direct descendants of supplied parent resource.list()provides a strongly consistent view of the folders underneath the specified parent resource.list()returns folders sorted based upon the (ascending) lexical ordering of their displayName. The caller must haveresourcemanager.folders.listpermission on the identified parent.
HTTP request
GET https://cloudresourcemanager.googleapis.com/v3/folders
Required. The name of the parent resource whose folders are being listed. Only children of this parent resource are listed; descendants are not listed.
If the parent is a folder, use the valuefolders/{folder_id}. If the parent is an organization, use the valueorganizations/{org_id}.
Access to this method is controlled by checking theresourcemanager.folders.listpermission on theparent.
pageSize
integer
Optional. The maximum number of folders to return in the response. The server can return fewer folders than requested. If unspecified, server picks an appropriate default.
pageToken
string
Optional. A pagination token returned from a previous call tofolders.listthat indicates where this listing should continue from.
showDeleted
boolean
Optional. Controls whether folders in theDELETE_REQUESTEDstate should be returned. Defaults to false.
Request body
The request body must be empty.
Response body
The folders.list response message.
If successful, the response body contains data with the following structure:
[[["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-06-11 UTC."],[],[],null,["# Method: folders.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListFoldersResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists the folders that are direct descendants of supplied parent resource. `list()` provides a strongly consistent view of the folders underneath the specified parent resource. `list()` returns folders sorted based upon the (ascending) lexical ordering of their displayName. The caller must have `resourcemanager.folders.list` permission on the identified parent.\n\n### HTTP request\n\n`GET https://cloudresourcemanager.googleapis.com/v3/folders`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nThe folders.list response message.\n\nIf successful, the response body contains data with the following structure:\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n- `https://www.googleapis.com/auth/cloud-platform.read-only`\n- `https://www.googleapis.com/auth/cloudplatformfolders`\n- `https://www.googleapis.com/auth/cloudplatformfolders.readonly`\n\nFor more information, see the [Authentication Overview](/docs/authentication#authorization-gcp)."]]
