--- title: List organizations the user has access to --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/go) [Organizations](https://developers.cloudflare.com/api/go/resources/organizations) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # List organizations the user has access to client.Organizations.List(ctx, query) (\*SinglePage\[[Organization]()], error) GET/organizations Retrieve a list of organizations a particular user has access to. (Currently in Public Beta - see https://developers.cloudflare.com/fundamentals/organizations/) ##### Security
API Token The preferred authorization scheme for interacting with the Cloudflare API. Create a token. **Example:**Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY
API Email + API Key The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key. **Example:**X-Auth-Email: user@example.com The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys. **Example:**X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194
##### Accepted Permissions (at least one required) `User Details Write``User Details Read` ##### ParametersExpand Collapse
query OrganizationListParams ID param.Field\[\[]string]Optional Only return organizations with the specified IDs (ex. id=foo&id=bar). Send multiple elements by repeating the query value. Link to this property
Containing param.Field\[OrganizationListParamsContaining]Optional Account stringOptional Filter the list of organizations to the ones that contain this particular account. Link to this property Organization stringOptional Filter the list of organizations to the ones that contain this particular organization. Link to this property User stringOptional Filter the list of organizations to the ones that contain this particular user. IMPORTANT: Just because an organization “contains” a user is not a representation of any authorization or privilege to manage any resources therein. An organization “containing” a user simply means the user is managed by that organization. Link to this property
Link to this property
Name param.Field\[OrganizationListParamsName]Optional Contains stringOptional (case-insensitive) Filter the list of organizations to where the name contains a particular string. Link to this property EndsWith stringOptional (case-insensitive) Filter the list of organizations to where the name ends with a particular string. Link to this property StartsWith stringOptional (case-insensitive) Filter the list of organizations to where the name starts with a particular string. Link to this property
Link to this property PageSize param.Field\[int64]Optional The amount of items to return. Defaults to 10. maximum1000 minimum0 Link to this property PageToken param.Field\[string]Optional An opaque token returned from the last list response that when provided will retrieve the next page. Parameters used to filter the retrieved list must remain in subsequent requests with a page token. Link to this property
Parent param.Field\[OrganizationListParamsParent]Optional
ID OrganizationListParamsParentIDOptional Filter the list of organizations to the ones that are a sub-organization of the specified organization. “null” is a valid value to provide for this parameter. It means “where an organization has no parent (i.e. it is a ‘root’ organization).” One of the following: string Link to this property type OrganizationListParamsParentID string Filter the list of organizations to the ones that are a sub-organization of the specified organization. “null” is a valid value to provide for this parameter. It means “where an organization has no parent (i.e. it is a ‘root’ organization).” Link to this property
Link to this property
Link to this property
[Link to this property](<#(resource)%20organizations%20%3E%20(method)%20list%20%3E%20(params)%20default>) ##### ReturnsExpand Collapse
type Organization struct{…} References an Organization in the Cloudflare data model. ID string Link to this property CreateTime Time formatdate-time Link to this property
Meta OrganizationMeta HierarchyTags \[]stringOptional Ordered chain of organization tags from the root organization down to (and including) this organization itself. Root organizations return a single-element array containing their own tag; sub-organizations return [rootTag, ...intermediateTags, parentTag, selfTag]. Useful for constructing authorization scopes that need to cover every ancestor in the hierarchy. Link to this property ManagedBy stringOptional Link to this property
TenantFlags OrganizationMetaTenantFlagsOptional Enable features for Organizations. AccountCreation string Link to this property AccountCreationAppliesTenantDefaults string Link to this property AccountDeletion string Link to this property AccountMigration string Link to this property AccountMobility string Link to this property EnterpriseCapability string Link to this property MemberManagement string Link to this property SubOrgCreation string Link to this property
Link to this property
Link to this property Name string Link to this property
Parent OrganizationParentOptional ID string Link to this property Name string Link to this property
Link to this property
Profile AccountProfileOptional BusinessAddress string Link to this property BusinessEmail string Link to this property BusinessName string Link to this property BusinessPhone string Link to this property ExternalMetadata string Link to this property
Link to this property
[Link to this property](<#(resource)%20organizations%20%3E%20(model)%20organization%20%3E%20(schema)>) ### List organizations the user has access to Go HTTPTypeScriptPythonGoTerraform ``` package main import ( "context" "fmt" "github.com/cloudflare/cloudflare-go" "github.com/cloudflare/cloudflare-go/option" "github.com/cloudflare/cloudflare-go/organizations" ) func main() { client := cloudflare.NewClient( option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"), ) page, err := client.Organizations.List(context.TODO(), organizations.OrganizationListParams{ }) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", page) } ``` 200 example ``` { "errors": [], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "result": [ { "id": "a7b9c3d2e8f4a1b5c6d0e9f2a3b7c4d8", "create_time": "2019-12-27T18:11:19.117Z", "meta": { "hierarchy_tags": [ "string" ], "managed_by": "managed_by", "tenant_flags": { "account_creation": "account_creation", "account_creation_applies_tenant_defaults": "account_creation_applies_tenant_defaults", "account_deletion": "account_deletion", "account_migration": "account_migration", "account_mobility": "account_mobility", "enterprise_capability": "enterprise_capability", "member_management": "member_management", "sub_org_creation": "sub_org_creation" } }, "name": "name", "parent": { "id": "a7b9c3d2e8f4a1b5c6d0e9f2a3b7c4d8", "name": "name" }, "profile": { "business_address": "business_address", "business_email": "business_email", "business_name": "business_name", "business_phone": "business_phone", "external_metadata": "external_metadata" } } ], "result_info": { "next_page_token": "next_page_token", "total_size": 0 }, "success": true } ``` ##### Returns Examples 200 example ``` { "errors": [], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "result": [ { "id": "a7b9c3d2e8f4a1b5c6d0e9f2a3b7c4d8", "create_time": "2019-12-27T18:11:19.117Z", "meta": { "hierarchy_tags": [ "string" ], "managed_by": "managed_by", "tenant_flags": { "account_creation": "account_creation", "account_creation_applies_tenant_defaults": "account_creation_applies_tenant_defaults", "account_deletion": "account_deletion", "account_migration": "account_migration", "account_mobility": "account_mobility", "enterprise_capability": "enterprise_capability", "member_management": "member_management", "sub_org_creation": "sub_org_creation" } }, "name": "name", "parent": { "id": "a7b9c3d2e8f4a1b5c6d0e9f2a3b7c4d8", "name": "name" }, "profile": { "business_address": "business_address", "business_email": "business_email", "business_name": "business_name", "business_phone": "business_phone", "external_metadata": "external_metadata" } } ], "result_info": { "next_page_token": "next_page_token", "total_size": 0 }, "success": true } ```