--- title: Get tenant details --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [Tenants](https://developers.cloudflare.com/api/python/resources/tenants) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Get tenant details tenants.get(strtenant\_id) -> [Tenant]() GET/tenants/{tenant\_id} Retrieves a tenant’s identity, status, metadata, contacts, and organizational units. ##### 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%20%3E%20(method)%20get%20%3E%20(params)%20default%20%3E%20(param)%20tenant_id%20%3E%20(schema)>) ##### ReturnsExpand 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)>) ### Get tenant details 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 ) tenant = client.tenants.get( "tenant_id", ) print(tenant.customer_id) ``` 200 example ``` { "errors": [], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "result": { "cdate": "2019-12-27T18:11:19.117Z", "edate": "2019-12-27T18:11:19.117Z", "tenant_contacts": { "email": "email", "website": "website" }, "tenant_labels": [ "string" ], "tenant_metadata": { "dns": { "ns_pool": { "primary": "primary", "secondary": "secondary" } } }, "tenant_name": "tenant_name", "tenant_network": {}, "tenant_status": "tenant_status", "tenant_tag": "tenant_tag", "tenant_type": "tenant_type", "tenant_units": [ { "unit_memberships": [ {} ], "unit_metadata": {}, "unit_name": "unit_name", "unit_status": "unit_status", "unit_tag": "unit_tag" } ], "customer_id": "customer_id" }, "success": true } ``` ##### Returns Examples 200 example ``` { "errors": [], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "result": { "cdate": "2019-12-27T18:11:19.117Z", "edate": "2019-12-27T18:11:19.117Z", "tenant_contacts": { "email": "email", "website": "website" }, "tenant_labels": [ "string" ], "tenant_metadata": { "dns": { "ns_pool": { "primary": "primary", "secondary": "secondary" } } }, "tenant_name": "tenant_name", "tenant_network": {}, "tenant_status": "tenant_status", "tenant_tag": "tenant_tag", "tenant_type": "tenant_type", "tenant_units": [ { "unit_memberships": [ {} ], "unit_metadata": {}, "unit_name": "unit_name", "unit_status": "unit_status", "unit_tag": "unit_tag" } ], "customer_id": "customer_id" }, "success": true } ```