--- title: List organizations the user has access to --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api) [Organizations](https://developers.cloudflare.com/api/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 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` ##### Q uery ParametersExpand Collapse id: optional array of string Only return organizations with the specified IDs (ex. id=foo&id=bar). Send multiple elements by repeating the query value. [Link to this property](<#(resource)%20organizations%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20id%20%3E%20(schema)>)

containing: optional object {account, organization, user }

account: optional string Filter the list of organizations to the ones that contain this particular account. Link to this property organization: optional string Filter the list of organizations to the ones that contain this particular organization. Link to this property user: optional string 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](<#(resource)%20organizations%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20containing%20%3E%20(schema)>)

name: optional object {contains, endsWith, startsWith }

contains: optional string (case-insensitive) Filter the list of organizations to where the name contains a particular string. Link to this property endsWith: optional string (case-insensitive) Filter the list of organizations to where the name ends with a particular string. Link to this property startsWith: optional string (case-insensitive) Filter the list of organizations to where the name starts with a particular string. Link to this property

[Link to this property](<#(resource)%20organizations%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20name%20%3E%20(schema)>) page\_size: optional number The amount of items to return. Defaults to 10. maximum1000 minimum0 [Link to this property](<#(resource)%20organizations%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20page_size%20%3E%20(schema)>) page\_token: optional string 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](<#(resource)%20organizations%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20page_token%20%3E%20(schema)>)

parent: optional object {id }

id: optional stringor "null" 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: OrganizationsAPIOrganizationID = string Link to this property "null" 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](<#(resource)%20organizations%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20parent%20%3E%20(schema)>) ##### ReturnsExpand Collapse errors: array of unknown [Link to this property](<#(resource)%20organizations%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20errors>)

messages: array of ResponseInfo { code, message, documentation\_url, source }

code: number minimum1000 Link to this property message: string Link to this property documentation\_url: optional string Link to this property

source: optional object {pointer }

pointer: optional string Link to this property

Link to this property

[Link to this property](<#(resource)%20organizations%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20messages>)

result: array of Organization { id, create\_time, meta, 3 more }

id: string Link to this property create\_time: string formatdate-time Link to this property

meta: object {hierarchy\_tags, managed\_by, tenant\_flags }

hierarchy\_tags: optional array of string 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 managed\_by: optional string Link to this property

tenant\_flags: optional object {account\_creation, account\_creation\_applies\_tenant\_defaults, account\_deletion, 5 more } Enable features for Organizations.

account\_creation: string Link to this property account\_creation\_applies\_tenant\_defaults: string Link to this property account\_deletion: string Link to this property account\_migration: string Link to this property account\_mobility: string Link to this property enterprise\_capability: string Link to this property member\_management: string Link to this property sub\_org\_creation: string Link to this property

Link to this property

Link to this property name: string Link to this property

parent: optional object {id, name }

id: string Link to this property name: string Link to this property

Link to this property

profile: optional AccountProfile { business\_address, business\_email, business\_name, 2 more }

business\_address: string Link to this property business\_email: string Link to this property business\_name: string Link to this property business\_phone: string Link to this property external\_metadata: string Link to this property

Link to this property

[Link to this property](<#(resource)%20organizations%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20result>)

result\_info: object {next\_page\_token, total\_size }

next\_page\_token: optional string Use this opaque token in the next request to retrieve the next page. Parameters used to filter the retrieved list must remain in subsequent requests with a page token. Link to this property total\_size: optional number Counts the total amount of items in a list with the applied filters. The API omits next\_page\_token to indicate no more items in a particular list. Link to this property

[Link to this property](<#(resource)%20organizations%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20result_info>) success: true [Link to this property](<#(resource)%20organizations%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20success>) ### List organizations the user has access to HTTP HTTPTypeScriptPythonGoTerraform ``` curl https://api.cloudflare.com/client/v4/organizations \ -H "Authorization: Bearer $CLOUDFLARE_API_TOKEN" ``` 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 } ```