--- title: Tenants --- [Skip to content](#_top) [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 details](https://developers.cloudflare.com/api/python/resources/tenants/methods/get) tenants.get(strtenant\_id) -> [Tenant]() GET/tenants/{tenant\_id} ##### ModelsExpand Collapse
class Tenant: … cdate: datetime formatdate-time Link to this property edate: datetime formatdate-time Link to this property
tenant\_contacts: TenantContacts email: Optional\[str] Link to this property website: Optional\[str] Link to this property
Link to this property tenant\_labels: List\[str] Link to this property
tenant\_metadata: TenantMetadata
dns: Optional\[TenantMetadataDNS]
ns\_pool: TenantMetadataDNSNSPool primary: Optional\[str] Link to this property secondary: Optional\[str] Link to this property
Link to this property
Link to this property
Link to this property tenant\_name: str Link to this property tenant\_network: object Link to this property tenant\_status: str Link to this property tenant\_tag: str Link to this property tenant\_type: str Link to this property
tenant\_units: List\[TenantUnit] unit\_memberships: List\[object] Link to this property unit\_metadata: object Link to this property unit\_name: str Link to this property unit\_status: str Link to this property unit\_tag: str Link to this property
Link to this property customer\_id: Optional\[str] Link to this property
[Link to this property](<#(resource)%20tenants%20%3E%20(model)%20tenant%20%3E%20(schema)>) #### TenantsAccount Types ##### [List tenant account types](https://developers.cloudflare.com/api/python/resources/tenants/subresources/account_types/methods/list) tenants.account\_types.list(strtenant\_id) -> SyncSinglePage\[[AccountTypeListResponse]()] GET/tenants/{tenant\_id}/account\_types ##### ModelsExpand Collapse str [Link to this property](<#(resource)%20tenants.account_types%20%3E%20(model)%20account_type_list_response%20%3E%20(schema)>) #### TenantsAccounts ##### [List tenant accounts](https://developers.cloudflare.com/api/python/resources/tenants/subresources/accounts/methods/list) tenants.accounts.list(strtenant\_id) -> SyncSinglePage\[[TenantAccount]()] GET/tenants/{tenant\_id}/accounts ##### ModelsExpand 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)>) #### TenantsEntitlements ##### [List tenant entitlements](https://developers.cloudflare.com/api/python/resources/tenants/subresources/entitlements/methods/get) tenants.entitlements.get(strtenant\_id) -> [TenantEntitlements]() GET/tenants/{tenant\_id}/entitlements ##### ModelsExpand Collapse
class TenantEntitlements: …
allow\_add\_subdomain: AllowAddSubdomain type: Literal\["bool"] Link to this property value: bool Link to this property
Link to this property
allow\_auto\_accept\_invites: AllowAutoAcceptInvites type: Literal\["bool"] Link to this property value: bool Link to this property
Link to this property
cname\_setup\_allowed: CNAMESetupAllowed type: Literal\["bool"] Link to this property value: bool Link to this property
Link to this property
custom\_entitlements: Optional\[List\[CustomEntitlement]]
allocation: CustomEntitlementAllocation One of the following:
class CustomEntitlementAllocationOrganizationsAPIMaxCountAllocation: … type: Literal\["max\_count"] Link to this property value: int Link to this property
Link to this property
class CustomEntitlementAllocationOrganizationsAPIBoolAllocation: … type: Literal\["bool"] Link to this property value: bool Link to this property
Link to this property
class CustomEntitlementAllocationOrganizationsAPINullAllocation: … type: Literal\[""] Link to this property value: Optional\[object] Link to this property
Link to this property
Link to this property
feature: CustomEntitlementFeature key: str Link to this property
Link to this property
Link to this property
mhs\_certificate\_count: MhsCertificateCount type: Literal\["max\_count"] Link to this property value: int Link to this property
Link to this property
partial\_setup\_allowed: PartialSetupAllowed type: Literal\["bool"] Link to this property value: bool Link to this property
Link to this property
[Link to this property](<#(resource)%20tenants.entitlements%20%3E%20(model)%20tenant_entitlements%20%3E%20(schema)>) #### TenantsMemberships ##### [List tenant memberships](https://developers.cloudflare.com/api/python/resources/tenants/subresources/memberships/methods/list) tenants.memberships.list(strtenant\_id) -> SyncSinglePage\[[TenantMembership]()] GET/tenants/{tenant\_id}/memberships ##### ModelsExpand Collapse
class TenantMembership: … user\_email: str Link to this property user\_name: str Link to this property user\_tag: str Link to this property
[Link to this property](<#(resource)%20tenants.memberships%20%3E%20(model)%20tenant_membership%20%3E%20(schema)>)