---
subcategory: "Cloud Platform"
description: |-
  Retrieve a set of folders based on a parent ID.
---

# google\_folders

Retrieve information about a set of folders based on a parent ID. See the
[REST API](https://cloud.google.com/resource-manager/reference/rest/v3/folders/list)
for more details.

## Example Usage - searching for folders at the root of an org

```hcl
data "google_folders" "my-org-folders" {
  parent_id = "organizations/${var.organization_id}"
}

data "google_folder" "first-folder" {
  folder = data.google_folders.my-org-folders.folders[0].name
}
```

## Argument Reference

The following arguments are supported:

* `parent_id` - (Required) A string parent as defined in the [REST API](https://cloud.google.com/resource-manager/reference/rest/v3/folders/list#query-parameters).


## Attributes Reference

The following attributes are exported:

* `folders` - A list of folders matching the provided filter. Structure is defined below.

The `folders` block supports:

* `name` - The id of the folder
* `parent` - The parent id of the folder
* `display_name` - The display name of the folder
* `state` - The lifecycle state of the folder
* `create_time` - The timestamp of when the folder was created
* `update_time` - The timestamp of when the folder was last modified
* `delete_time` - The timestamp of when the folder was requested to be deleted (if applicable)
* `etag` - Entity tag identifier of the folder