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/v2/folders
Required. The resource name of the Organization or Folder whose Folders are being listed. Must be of the formfolders/{folder_id}ororganizations/{org_id}. Access to this method is controlled by checking theresourcemanager.folders.listpermission on theparent.
Authorization requires the followingIAMpermission on the specified resourceparent:
resourcemanager.folders.list
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/v2/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)."]]
