---
subcategory: "Cloud Platform"
description: |-
  Get information about a Google Cloud Organization.
---

# google\_organization

Get information about a Google Cloud Organization. Note that you must have the `roles/resourcemanager.organizationViewer` role (or equivalent permissions) at the organization level to use this datasource.

```hcl
data "google_organization" "org" {
  domain = "example.com"
}

resource "google_folder" "sales" {
  display_name = "Sales"
  parent       = data.google_organization.org.name
}
```

## Argument Reference

The arguments of this data source act as filters for querying the available Organizations.
The given filters must match exactly one Organizations whose data will be exported as attributes.
The following arguments are supported:

* `organization` (Optional) - The Organization's numeric ID, including an optional `organizations/` prefix.

* `domain` (Optional) - The domain name of the Organization.

~> **NOTE:** One of `organization` or `domain` must be specified.

## Attributes Reference

The following additional attributes are exported:

* `org_id` - The Organization ID.

* `name` - The resource name of the Organization in the form `organizations/{organization_id}`.

* `directory_customer_id` - The Google for Work customer ID of the Organization.

* `create_time` - Timestamp when the Organization was created. A timestamp in RFC3339 UTC "Zulu" format, accurate to nanoseconds. Example: "2014-10-02T15:01:23.045123456Z".

* `lifecycle_state` - The Organization's current lifecycle state.