---
title: "List Tenants Endpoint"
method: GET
path: "/admin/global-tenant-list"
tags: ["admin"]
---

# List Tenants Endpoint

`GET /admin/global-tenant-list`

## Response `200`

Successful Response

- Tenant[]
  - `id` string, required
  - `owner` Owner, required
    - `namespace` string, required
    - `owner_id` string, required
    - `display_name` string, nullable
  - `create_date_time` string, date-time, required
  - `nodes` Node[], required
    - `name` string, required
    - `connection_id` string, nullable
    - `key` string, required
    - `id` string, required
    - `create_date_time` string, date-time, required
    - `last_known_version` string, nullable
    - `last_known_features` string, nullable
    - `destroy_date_time` string, date-time, nullable
    - `infra_id` string, nullable
    - `demo` boolean, required
    - `ephemeral` boolean
  - `auth_functions` union[]
    - union
      - UserAuthFunction
        - `auth_fn` 'auth_user'
        - `user_id` string, required
      - EmailDomainFunction — Grants access for users from a specific connection (e.g. gmail) having email addresses from a given domain (e.g. @tenzir.com)
        - `auth_fn` 'auth_email_suffix'
        - `connection` string, nullable
        - `email_domain` string, required
      - OrganizationRoleFunction — Grants access to users who have some role in some organization.
        - `auth_fn` 'auth_organization_role'
        - `connection` string, nullable
        - `roles_claim` string, required
        - `role` string, required
        - `organization_claim` string, required
        - `organization` string, required
      - OrganizationMembershipFunction — Grants access to users that belong to some organization.
        - `auth_fn` 'auth_organization'
        - `connection` string, nullable
        - `organization_claim` string, required
        - `organization` string, required
      - AllowAllAuthFunction
        - `auth_fn` 'auth_allow_all'
  - `name` string
  - `icon_url` string
  - `alerts` object, nullable
  - `metrics_opt_out` boolean
  - `secret_stores` SecretStoreDetails[]
    - `type` 'aws' | 'tenzir', required
    - `id` string, required
    - `name` string, required
    - `is_writable` boolean, required
    - `is_deletable` boolean, required
    - `options` union, required
      - AwsWorkspaceSecretOptions
        - `region` string, required
        - `assumed_role_arn` string, required
        - `access_key` AwsAccessKey
          - `access_key_id` string, required
          - `secret_access_key` string, password, required
      - BuiltinWorkspaceSecretOptions
        - `derived_key` DerivedKey
          - `public_key` string, required
          - `keypath` string, required
  - `current_default_secret_store` string
  - `node_registration_key` string, nullable

---

[API](https://skmtc.dev/tenzir/apis/tenzir-platform-api.md) · [All operations](https://skmtc.dev/tenzir/apis/tenzir-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tenzir/tenzir-platform-api/revisions/1c6c33bb8ba3/schema)