---
title: "Get Top Budget By Tenant"
method: POST
path: "/cost/executive_dashboard/top_budgets"
tags: ["Cost"]
---

# Get Top Budget By Tenant

`POST /cost/executive_dashboard/top_budgets`

View Top Budget By Tenant.

## Request body

- TopBudgetByTenantRequest
  - `filter` AccountFilters
    - `tenants` string[] — Tenants to include (all if missing)
    - `clouds` string[] — Cloud Providers to include (all if missing)
    - `cloud_accounts` string[] — Cloud Accounts to include (all if missing)
    - `regions` string[] — Regions to include (all if missing)
    - `resource_filter` string[] — Resources filter to filter (all if missing)
    - `product_categories` string[] — Product Categories to include (all if missing)
    - `category` string — Inventory Category of the resources to filter (all if missing)
    - `resource_type` string[] — Type of Resources to include (all if missing)
  - `currency` 'AED' | 'ALL' | 'ARS' | 'AUD' | 'BAM' | 'BDT' | 'BGN' | 'BHD' | 'BRL' | 'CAD' | 'CHF' | 'CLP' | 'CNY' | 'COP' | 'CRC' | 'CZK' | 'DKK' | 'EGP' | 'EUR' | 'GBP' | 'HKD' | 'HRK' | 'HUF' | 'IDR' | 'ILS' | 'INR' | 'ISK' | 'JPY' | 'KES' | 'KRW' | 'KWD' | 'KZT' | 'MOP' | 'MVR' | 'MXN' | 'MYR' | 'NOK' | 'NZD' | 'OMR' | 'PEN' | 'PHP' | 'PKR' | 'PLN' | 'QAR' | 'RON' | 'RSD' | 'RUB' | 'SAR' | 'SEK' | 'SGD' | 'THB' | 'TRY' | 'TWD' | 'USD' | 'VND' | 'ZAR', required — currency of the cost. Example 'currency':'USD'
  - `start_date` string, date-time — specify the start date. start_date: yyyy-mm-dd
  - `end_date` string, date-time — specify the end date. end_date: yyyy-mm-dd
  - `time_zone` string — Optional timezone of the caller
  - `time_range` RangeSelection
    - `range` 'Last15Minutes' | 'Last30Minutes' | 'Last60Minutes' | 'Hour' | 'PreviousHour' | 'Last3Hours' | 'Last6Hours' | 'Last12Hours' | 'Last24Hours' | 'FullDay' | 'Today' | 'Yesterday' | 'Last2Days' | 'Last3Days' | 'Last7Days' | 'Last14Days' | 'Week' | 'WeekToDate' | 'LastWeekToNow' | 'Last2WeeksToNow' | 'PreviousWeek' | 'Previous2Weeks' | 'Previous4Weeks' | 'FullMonth' | 'Month' | 'MonthToDate' | 'PreviousMonth' | 'LastMonthToNow' | 'Previous3Months' | 'Previous6Months' | 'Previous12Months' | 'TwoMonthsAgo' | 'ThreeMonthsAgo' | 'Last30Days' | 'FullQuarter' | 'Quarter' | 'QuarterToDate' | 'LastQuarterToNow' | 'LastQuarterToDate' | 'PreviousQuarter' | 'Previous2Quarters' | 'Previous3Quarters' | 'Previous4Quarters' | 'Last3Months' | 'Last3MonthsToNow' | 'Last6MonthsToNow' | 'Last12MonthsToNow' | 'FullYear' | 'Year' | 'YearToDate' | 'PreviousYear' | 'Previous3Years' | 'Last365Days' | 'BillingCurrentMonth' | 'BillingPreviousMonth' | 'BillingCurrentQuarter' | 'BillingPreviousQuarter' | 'BillingPrevious3Months' | 'BillingPrevious6Months' | 'FiscalPreviousQuarter' | 'FiscalCurrentQuarter' | 'FiscalCurrentQuarterToNow' | 'FiscalPreviousHalfYear' | 'FiscalCurrentHalfYear' | 'FiscalPreviousYear' | 'FiscalCurrentYear' | 'FiscalCurrentYearToNow' | 'FiscalLast3Years' | 'FiscalYearToDate' | 'All'
    - `start` string, date-time
    - `end` string, date-time
    - `zoneCreated` string
    - `zone` string
  - `query` QueryOperator
    - `__type` string, required — Concrete type used for polymorphic deserialization (discriminator)

## Response `200`

Success

- TopBudgetByTenant[]
  - `tenant_id` string
  - `budget_details` Budget[]
    - `budget_period` string
    - `budget_amount` number

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