Get tenant details
A Tenant Admin's unit and membership details will be used for access of resources and all Tenant operations on the API. The unit ID (unit_tag), for example, can be used to create an account on a specific unit.
This is especially useful when a Tenant Admin has multiple units and wants to create an account on a specific unit. All accounts created are associated with the units, each of which can have one or more memberships.
To retrieve tenant details, send a GET request to the /user/tenants endpoint:
curl "https://api.cloudflare.com/client/v4/user/tenants" \--header "X-Auth-Email: <EMAIL>" \--header "X-Auth-Key: <API_KEY>"A successful request will return an HTTP status of 200 and a response body containing tenant information, unit information, memberships, and tenant entitlements for all tenants administered by the user.
Was this helpful?
- Resources
- API
- New to Cloudflare?
- Products
- Sponsorships
- Open Source
- Support
- Help Center
- System Status
- Compliance
- GDPR
- Company
- cloudflare.com
- Our team
- Careers
- 2025 Cloudflare, Inc.
- Privacy Policy
- Terms of Use
- Report Security Issues
- Trademark