Cloudflare Docs
Tenant
Edit this page
Report an issue with this page
Log into the Cloudflare dashboard
Set theme to dark (⇧+D)

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:
Request
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.