---
title: "List Tenant"
method: GET
path: "/tenants"
tags: ["Identity"]
---

# List Tenant

`GET /tenants`

There can be multiple tenants within a CoreStack account. List all tenants the user is mapped under a CoreStack account. If there are 3 tenants and user performing this operation has access to only 2 tenants then only those 2 tenants will be returned.

## Response `200`

Success

- ListTenantResponse
  - `tenants` TenantDetails[], required — Tenants List.
    - `tenant_id` string, required — Id of the tenant. This will be used for performing tenant level operations such as createPolicy, createScript, onboardCloudAccount and so on.
    - `name` string, required — Unique name of the tenant provided as input while creating.
    - `description` string, required — Description of the tenant.
    - `account_id` string, required — Id of the CoreStack account under which this tenant resides.
    - `is_default` boolean, required — Is the master tenant
    - `fiscal_year_configuration` FiscalYearConfiguration
      - `start` string — Start Date for Financial Year in DD-MMM format
      - `end` string — End Date for Financial Year in DD-MMM format
    - `cost_anomaly_settings` CostAnomalyConfiguration
      - `threshold_configuration` CostAnomalySetting
        - `category` 'all' | 'product_category' | 'resource_category' — Cost anomaly settings category.
        - `category_values` string[] — List of categories.
        - `minimum_cost_spend` integer — Minimum Cost Spend
        - `minimum_cost_impact` integer — Minimum Cost Impact
        - `minimum_cost_impact_percentage` integer — Minimum Cost Anomaly Impact Percentage
        - `cost_impact_spend_operator` 'and' | 'or' — Cost Impact and Spend condition
      - `notifications` ConfigurationForCostAnomalyNotification[] — Notification configuration.
        - `enabled` boolean — Whether Notifications Are Enabled
        - `emails` string[] — Emails
        - `webhooks` string[] — Webhooks
        - `microsoft_teams_webhooks` string[] — Microsoft Teams Webhooks
        - `enable_realtime_notification` boolean — Specifies whether realtime notification enabled or not.
        - `enable_daily_summary_notification` boolean — Specifies whether daily summary notification enabled or not.
    - `cost_processing_settings` CostProcessingSettings
      - `max_tag_value_count` integer — Maximum number of unique values per tag to process for cost allocation tags
      - `number_of_months_to_backfill` integer — Back filling value for cost processing (in months)
    - `azure_hybrid_benefits_enabled` boolean — azure hybrid benefits enabled under finOps
    - `disk_utilization_settings` DiskUtilizationSetting
      - `settings` DiskUtilizationWorkspaceConfiguration[]
        - `workspace_ids` string[] — Log Analytics Workspace Ids
        - `service_account_id` string — Service Account Id
    - `dimension_settings` DimensionTenantSettings[]
      - `product` 'AppSecOps' | 'Assessments' | 'CloudOps' | 'FinOps' | 'Product_Admin' | 'SecOps' | 'Self Service' | 'StackOps', required — Name of the product
      - `mandate_dimension_selection` boolean — Mandate Dimension Selection
    - `status` 'active' | 'suspended', required — Indicates the status of the Tenant
    - `created_at` string, required — Created DateTime in UTC of the tenant.
    - `activity_queue_notifications` ActivityQueueNotificationDetails
      - `activity` ActivityQueueNotifications
        - `enabled` boolean — Activity Queue Notifications enabled
        - `integrated_tool_account` IntegratedToolAccount
          - `id` string — Tool Account ID
      - `alerts` ActivityQueueNotifications
        - `enabled` boolean — Activity Queue Notifications enabled
        - `integrated_tool_account` IntegratedToolAccount
          - `id` string — Tool Account ID
      - `policies` ActivityQueueNotifications
        - `enabled` boolean — Activity Queue Notifications enabled
        - `integrated_tool_account` IntegratedToolAccount
          - `id` string — Tool Account ID
      - `scripts` ActivityQueueNotifications
        - `enabled` boolean — Activity Queue Notifications enabled
        - `integrated_tool_account` IntegratedToolAccount
          - `id` string — Tool Account ID
      - `templates` ActivityQueueNotifications
        - `enabled` boolean — Activity Queue Notifications enabled
        - `integrated_tool_account` IntegratedToolAccount
          - `id` string — Tool Account ID
      - `security_alerts` ActivityQueueNotifications
        - `enabled` boolean — Activity Queue Notifications enabled
        - `integrated_tool_account` IntegratedToolAccount
          - `id` string — Tool Account ID
      - `inventory_update` ActivityQueueNotifications
        - `enabled` boolean — Activity Queue Notifications enabled
        - `integrated_tool_account` IntegratedToolAccount
          - `id` string — Tool Account ID
      - `automation_failure` ActivityQueueNotifications
        - `enabled` boolean — Activity Queue Notifications enabled
        - `integrated_tool_account` IntegratedToolAccount
          - `id` string — Tool Account ID
      - `budget_alerts` ActivityQueueNotifications
        - `enabled` boolean — Activity Queue Notifications enabled
        - `integrated_tool_account` IntegratedToolAccount
          - `id` string — Tool Account ID

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `500` — Internal Server Error

---

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