---
title: "Get Tenant"
method: GET
path: "/tenants/{tenant_id}"
tags: ["Identity"]
---

# Get Tenant

`GET /tenants/{tenant_id}`

Retrieve a tenant by its Id.  If you're unsure of the tenant_id, use listTenant operation to list all tenants under a CoreStack account and fetch the needed tenant_id.

## Path parameters

- `tenant_id` string, required

## Response `200`

Success

- GetTenantResponse
  - `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
  - `metadata` object, required — metadata is a freeform JSON. It allows to store custom keys and values. It will be useful for storing information about an external applications that will refer to CoreStack tenant
  - `created_by` string, required — Name of the user created this tenant.
  - `updated_by` string, required — Name of the user last updated this tenant.
  - `updated_at` string, required — DateTime in UTC when the tenant was last updated.
  - `account_name` string, required — Name of the CoreStack account under which this tenant resides.

## 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)