--- title: List tenant accounts --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [Tenants](https://developers.cloudflare.com/api/python/resources/tenants) [Accounts](https://developers.cloudflare.com/api/python/resources/tenants/subresources/accounts) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # List tenant accounts tenants.accounts.list(strtenant\_id) -> SyncSinglePage\[[TenantAccount]()] GET/tenants/{tenant\_id}/accounts Lists the Cloudflare accounts associated with this tenant. ##### Security 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` ##### ParametersExpand Collapse tenant\_id: str [Link to this property](<#(resource)%20tenants.accounts%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20tenant_id%20%3E%20(schema)>) ##### ReturnsExpand Collapse
class TenantAccount: … id: str Link to this property created\_on: datetime formatdate-time Link to this property name: Optional\[str] Link to this property
settings: Settings abuse\_contact\_email: Optional\[str] Link to this property access\_approval\_expiry: Optional\[datetime] formatdate-time Link to this property api\_access\_enabled: Optional\[bool] Link to this property Deprecateddefault\_nameservers: Optional\[str] Use DNS Settings instead. Deprecated. Link to this property enforce\_twofactor: Optional\[bool] Link to this property Deprecateduse\_account\_custom\_ns\_by\_default: Optional\[bool] Use DNS Settings instead. Deprecated. Link to this property
Link to this property
type: Literal\["standard", "enterprise"] One of the following: "standard" Link to this property "enterprise" Link to this property
Link to this property tags: Optional\[Dict\[str, str]] Account tags, present only when include_tags=true is requested. Link to this property
[Link to this property](<#(resource)%20tenants.accounts%20%3E%20(model)%20tenant_account%20%3E%20(schema)>) ### List tenant accounts Python HTTPTypeScriptPythonGoTerraform ``` import os from cloudflare import Cloudflare client = Cloudflare( api_email=os.environ.get("CLOUDFLARE_EMAIL"), # This is the default and can be omitted api_key=os.environ.get("CLOUDFLARE_API_KEY"), # This is the default and can be omitted ) page = client.tenants.accounts.list( "tenant_id", ) page = page.result[0] print(page.id) ``` 200 example ``` { "errors": [], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "result": [ { "id": "id", "created_on": "2019-12-27T18:11:19.117Z", "name": "name", "settings": { "abuse_contact_email": "abuse_contact_email", "access_approval_expiry": "2019-12-27T18:11:19.117Z", "api_access_enabled": true, "default_nameservers": "default_nameservers", "enforce_twofactor": true, "use_account_custom_ns_by_default": true }, "type": "standard", "tags": { "foo": "string" } } ], "success": true } ``` ##### Returns Examples 200 example ``` { "errors": [], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "result": [ { "id": "id", "created_on": "2019-12-27T18:11:19.117Z", "name": "name", "settings": { "abuse_contact_email": "abuse_contact_email", "access_approval_expiry": "2019-12-27T18:11:19.117Z", "api_access_enabled": true, "default_nameservers": "default_nameservers", "enforce_twofactor": true, "use_account_custom_ns_by_default": true }, "type": "standard", "tags": { "foo": "string" } } ], "success": true } ```