---
title: Tenants
---

[Skip to content](#%5Ftop) 

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

Copy Markdown

Open in **Claude**

Open in **ChatGPT**

Open in **Cursor**

---

**Copy Markdown**

**View as Markdown**

# Tenants

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

GET/tenants/{tenant\_id}

##### ModelsExpand Collapse 

Tenant object { cdate, edate, tenant\_contacts, 9 more } 

cdate: string

formatdate-time

edate: string

formatdate-time

tenant\_contacts: object { email, website } 

email: optional string

website: optional string

tenant\_labels: array of string

tenant\_metadata: object { dns } 

dns: optional object { ns\_pool } 

ns\_pool: object { primary, secondary } 

primary: optional string

secondary: optional string

tenant\_name: string

tenant\_network: unknown

tenant\_status: string

tenant\_tag: string

tenant\_type: string

tenant\_units: array of object { unit\_memberships, unit\_metadata, unit\_name, 2 more } 

unit\_memberships: array of unknown

unit\_metadata: unknown

unit\_name: string

unit\_status: string

unit\_tag: string

customer\_id: optional string

#### TenantsAccount Types

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

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

##### ModelsExpand Collapse 

AccountTypeListResponse \= string

#### TenantsAccounts

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

GET/tenants/{tenant\_id}/accounts

##### ModelsExpand Collapse 

TenantAccount object { id, created\_on, name, 3 more } 

id: string

created\_on: string

formatdate-time

name: string

settings: object { abuse\_contact\_email, access\_approval\_expiry, api\_access\_enabled, 3 more } 

abuse\_contact\_email: string

access\_approval\_expiry: string

formatdate-time

api\_access\_enabled: boolean

Deprecateddefault\_nameservers: string

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

enforce\_twofactor: boolean

Deprecateduse\_account\_custom\_ns\_by\_default: boolean

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

type: "standard" or "enterprise"

One of the following:

"standard"

"enterprise"

tags: optional map\[string\]

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

#### TenantsEntitlements

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

GET/tenants/{tenant\_id}/entitlements

##### ModelsExpand Collapse 

TenantEntitlements object { allow\_add\_subdomain, allow\_auto\_accept\_invites, cname\_setup\_allowed, 3 more } 

allow\_add\_subdomain: object { type, value } 

type: "bool"

value: boolean

allow\_auto\_accept\_invites: object { type, value } 

type: "bool"

value: boolean

cname\_setup\_allowed: object { type, value } 

type: "bool"

value: boolean

custom\_entitlements: array of object { allocation, feature } 

allocation: object { type, value } or object { type, value } or object { type, value } 

One of the following:

OrganizationsAPIMaxCountAllocation object { type, value } 

type: "max\_count"

value: number

OrganizationsAPIBoolAllocation object { type, value } 

type: "bool"

value: boolean

OrganizationsAPINullAllocation object { type, value } 

type: ""

value: optional unknown

feature: object { key } 

key: string

mhs\_certificate\_count: object { type, value } 

type: "max\_count"

value: number

partial\_setup\_allowed: object { type, value } 

type: "bool"

value: boolean

#### TenantsMemberships

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

GET/tenants/{tenant\_id}/memberships

##### ModelsExpand Collapse 

TenantMembership object { user\_email, user\_name, user\_tag } 

user\_email: string

user\_name: string

user\_tag: string