--- title: List organizations the user has access to --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [Organizations](https://developers.cloudflare.com/api/python/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 organizations.list(OrganizationListParams\*\*kwargs) -> SyncSinglePage\[[Organization]()] 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 id: Optional\[Sequence\[str]] 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\[Containing] account: Optional\[str] Filter the list of organizations to the ones that contain this particular account. Link to this property organization: Optional\[str] Filter the list of organizations to the ones that contain this particular organization. Link to this property user: Optional\[str] 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\[Name] contains: Optional\[str] (case-insensitive) Filter the list of organizations to where the name contains a particular string. Link to this property ends\_with: Optional\[str] (case-insensitive) Filter the list of organizations to where the name ends with a particular string. Link to this property starts\_with: Optional\[str] (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\[int] 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\[str] 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\[Parent]
id: Optional\[Union\[str, Literal\["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: str Link to this property Literal\["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
class Organization: … References an Organization in the Cloudflare data model. id: str Link to this property create\_time: datetime formatdate-time Link to this property
meta: Meta hierarchy\_tags: Optional\[List\[str]] 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\[str] Link to this property
tenant\_flags: Optional\[MetaTenantFlags] Enable features for Organizations. account\_creation: str Link to this property account\_creation\_applies\_tenant\_defaults: str Link to this property account\_deletion: str Link to this property account\_migration: str Link to this property account\_mobility: str Link to this property enterprise\_capability: str Link to this property member\_management: str Link to this property sub\_org\_creation: str Link to this property
Link to this property
Link to this property name: str Link to this property
parent: Optional\[Parent] id: str Link to this property name: str Link to this property
Link to this property
profile: Optional\[Profile] business\_address: str Link to this property business\_email: str Link to this property business\_name: str Link to this property business\_phone: str Link to this property external\_metadata: str 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 Python HTTPTypeScriptPythonGoTerraform ``` import os from cloudflare import Cloudflare client = Cloudflare( api_token=os.environ.get("CLOUDFLARE_API_TOKEN"), # This is the default and can be omitted ) page = client.organizations.list() page = page.result[0] print(page.id) ``` 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 } ```