---
title: Tenants
---

[Skip to content](#%5Ftop) 

[API Reference](https://developers.cloudflare.com/api/python)

Copy Markdown

Open in **Claude**

Open in **ChatGPT**

Open in **Cursor**

---

**Copy Markdown**

**View as Markdown**

# Tenants

##### [Get tenant](https://developers.cloudflare.com/api/python/resources/tenants/methods/get)

tenants.get(strtenant\_id)  \-> [Tenant](https://developers.cloudflare.com/api/python/resources/tenants#%28resource%29%20tenants%20%3E%20%28model%29%20tenant%20%3E%20%28schema%29)

GET/tenants/{tenant\_id}

##### ModelsExpand Collapse 

class Tenant: …

cdate: datetime

formatdate-time

edate: datetime

formatdate-time

tenant\_contacts: TenantContacts

email: Optional\[str\]

website: Optional\[str\]

tenant\_labels: List\[str\]

tenant\_metadata: TenantMetadata

dns: Optional\[TenantMetadataDNS\]

ns\_pool: TenantMetadataDNSNSPool

primary: Optional\[str\]

secondary: Optional\[str\]

tenant\_name: str

tenant\_network: object

tenant\_status: str

tenant\_tag: str

tenant\_type: str

tenant\_units: List\[TenantUnit\]

unit\_memberships: List\[object\]

unit\_metadata: object

unit\_name: str

unit\_status: str

unit\_tag: str

customer\_id: Optional\[str\]

#### TenantsAccount Types

##### [Get tenant account types](https://developers.cloudflare.com/api/python/resources/tenants/subresources/account%5Ftypes/methods/list)

tenants.account\_types.list(strtenant\_id)  \-> SyncSinglePage\[[AccountTypeListResponse](https://developers.cloudflare.com/api/python/resources/tenants#%28resource%29%20tenants.account%5Ftypes%20%3E%20%28model%29%20account%5Ftype%5Flist%5Fresponse%20%3E%20%28schema%29)\]

GET/tenants/{tenant\_id}/account\_types

##### ModelsExpand Collapse 

str

#### TenantsAccounts

##### [List tenant accounts](https://developers.cloudflare.com/api/python/resources/tenants/subresources/accounts/methods/list)

tenants.accounts.list(strtenant\_id)  \-> SyncSinglePage\[[TenantAccount](https://developers.cloudflare.com/api/python/resources/tenants#%28resource%29%20tenants.accounts%20%3E%20%28model%29%20tenant%5Faccount%20%3E%20%28schema%29)\]

GET/tenants/{tenant\_id}/accounts

##### ModelsExpand Collapse 

class TenantAccount: …

id: str

created\_on: datetime

formatdate-time

name: Optional\[str\]

settings: Settings

abuse\_contact\_email: Optional\[str\]

access\_approval\_expiry: Optional\[datetime\]

formatdate-time

api\_access\_enabled: Optional\[bool\]

Deprecateddefault\_nameservers: Optional\[str\]

Use [DNS Settings](https://developers.cloudflare.com/api/operations/dns-settings-for-an-account-list-dns-settings) instead. Deprecated.

enforce\_twofactor: Optional\[bool\]

Deprecateduse\_account\_custom\_ns\_by\_default: Optional\[bool\]

Use [DNS Settings](https://developers.cloudflare.com/api/operations/dns-settings-for-an-account-list-dns-settings) instead. Deprecated.

type: Literal\["standard", "enterprise"\]

One of the following:

"standard"

"enterprise"

tags: Optional\[Dict\[str, str\]\]

Account tags, present only when `include_tags=true` is requested.

#### TenantsEntitlements

##### [List tenant entitlements](https://developers.cloudflare.com/api/python/resources/tenants/subresources/entitlements/methods/get)

tenants.entitlements.get(strtenant\_id)  \-> [TenantEntitlements](https://developers.cloudflare.com/api/python/resources/tenants#%28resource%29%20tenants.entitlements%20%3E%20%28model%29%20tenant%5Fentitlements%20%3E%20%28schema%29)

GET/tenants/{tenant\_id}/entitlements

##### ModelsExpand Collapse 

class TenantEntitlements: …

allow\_add\_subdomain: AllowAddSubdomain

type: Literal\["bool"\]

value: bool

allow\_auto\_accept\_invites: AllowAutoAcceptInvites

type: Literal\["bool"\]

value: bool

cname\_setup\_allowed: CNAMESetupAllowed

type: Literal\["bool"\]

value: bool

custom\_entitlements: Optional\[List\[CustomEntitlement\]\]

allocation: CustomEntitlementAllocation

One of the following:

class CustomEntitlementAllocationOrganizationsAPIMaxCountAllocation: …

type: Literal\["max\_count"\]

value: int

class CustomEntitlementAllocationOrganizationsAPIBoolAllocation: …

type: Literal\["bool"\]

value: bool

class CustomEntitlementAllocationOrganizationsAPINullAllocation: …

type: Literal\[""\]

value: Optional\[object\]

feature: CustomEntitlementFeature

key: str

mhs\_certificate\_count: MhsCertificateCount

type: Literal\["max\_count"\]

value: int

partial\_setup\_allowed: PartialSetupAllowed

type: Literal\["bool"\]

value: bool

#### TenantsMemberships

##### [List tenant memberships](https://developers.cloudflare.com/api/python/resources/tenants/subresources/memberships/methods/list)

tenants.memberships.list(strtenant\_id)  \-> SyncSinglePage\[[TenantMembership](https://developers.cloudflare.com/api/python/resources/tenants#%28resource%29%20tenants.memberships%20%3E%20%28model%29%20tenant%5Fmembership%20%3E%20%28schema%29)\]

GET/tenants/{tenant\_id}/memberships

##### ModelsExpand Collapse 

class TenantMembership: …

user\_email: str

user\_name: str

user\_tag: str