---
title: "GET /api/v1/config/consumption-budgets"
method: GET
path: "/api/v1/config/consumption-budgets"
tags: ["ConsumptionBudget"]
---

# GET /api/v1/config/consumption-budgets

`GET /api/v1/config/consumption-budgets`

## Query parameters

- `page.max_size` integer
- `page.token` string
- `slugs` string[]
- `names` string[]
- `partition_slug_paths` string[]
- `resources` string[]

## Response `200`

A successful response.

- Configv1ListConsumptionBudgetsResponse
  - `consumption_budgets` Configv1ConsumptionBudget[]
    - `alert_action_config` ConsumptionBudgetAlertActionConfig
      - `annotations` object — Additional annotations to set on the generated monitor. By default, the monitors already contain "description", "dashboard", "resource", "consumption_budget_slug", "threshold_type", and "partition" annotations. Setting any of these annotations will override its default value.
      - `instant_rate_sustain_secs` integer — How long instant rate consumption must sustain above the threshold in order to fire an alert. By default, the sustain is 0: any consumption over the threshold will fire an alert.
      - `labels` object — Additional labels to set on the generated monitor, which can be used for notification routing. The following labels are reserved and cannot be override: "resource", "partition", and "threshold_type".
    - `created_at` string, date-time — Timestamp of when the ConsumptionBudget was created. Cannot be set by clients.
    - `default_priority` integer — Optional. The default priority for requests that don't match any priority in the `priorities` list. If not set, then `priority=10` (dropped first) is used as the default.
    - `name` string, required — The name of the ConsumptionBudget. You can modify this value after the ConsumptionBudget is created.
    - `notification_policy_slug` string — Notification policy slug for routing alerts. Required only if `ALERT_WARN` or `ALERT_CRITICAL` actions are configured.
    - `partition_slug_path` string, required — Path of the budget's partition, delimited by forward slashes (`/`), in the format `global/SLUG1/SLUG2`, where `SLUG1` is a top-level partition, and `SLUG2` is a child partition of `SLUG1`. A well-formed partition path always starts with the `global` partition slug, and has no leading or trailing forward slashes.
    - `priorities` ConsumptionBudgetPriority[] — Optional. Controls the order in which data is dropped when a drop action is applied. For example, a priority of 10 is dropped first, and a priority of 1 is dropped last. Priorities are evaluated in match order, and the first priority to match is applied. All other priorities are ignored. If a request does not match any priority, then it is assigned the `default_priority`.
      - `filters` ConsumptionBudgetPriorityFilter[], required — Criteria that defines which data matches the `priority`. Filters are concatenated together as implied `AND` operators. A request must match every filter to match the `priority`.
        - `dataset_slug` string — Deprecated. Use `log_filter` instead.
        - `log_filter` Configv1LogSearchFilter
          - `query` string — Returns logs that match this query. The query can include only top-level operations. Nested clauses aren't supported. Only one type of `AND` or `OR` operator is allowed.
      - `priority` integer, required — Priority order that determines when to drop data. A priority of `10` is dropped first, and a priority of `1` is dropped last.
    - `resource` 'LOG_PERSISTED_BYTES' | 'LOG_PROCESSED_BYTES' | 'METRIC_PERSISTED_SERIES' | 'METRIC_ALL' | 'LOG_ALL' | 'TRACE_PROCESSED_BYTES' | 'TRACE_PERSISTED_BYTES' | 'TRACE_ALL' | 'ALL'
    - `slug` string — The unique identifier of the ConsumptionBudget. If a `slug` isn't provided, one is generated based on the `name` field. You can't modify this field after the ConsumptionBudget is created.
    - `thresholds` Configv1ConsumptionBudgetThreshold[] — Optional. Defines which actions to take when a threshold is exceeded.
      - `action` 'ALERT_WARN' | 'ALERT_CRITICAL' | 'DROP', required
      - `instant_rate` ThresholdInstantRate
        - `fixed_value_per_sec` string, int64, required — Value of the fixed rate threshold.
      - `resource_group` 'LOG_PERSISTED_BYTES' | 'LOG_PROCESSED_BYTES' | 'METRIC_PERSISTED_SERIES' | 'METRIC_ALL' | 'LOG_ALL' | 'TRACE_PROCESSED_BYTES' | 'TRACE_PERSISTED_BYTES' | 'TRACE_ALL' | 'ALL'
      - `type` 'DAILY_VOLUME' | 'INSTANT_RATE' | 'WEEKLY_VOLUME' | 'MONTHLY_VOLUME' | 'HOURLY_VOLUME' | 'ROLLING_1_HOUR_VOLUME' | 'ROLLING_3_HOUR_VOLUME' | 'ROLLING_1_DAY_VOLUME' | 'ROLLING_7_DAY_VOLUME' | 'ROLLING_30_MINUTE_VOLUME', required
      - `unit` 'NATIVE' | 'CREDITS'
      - `volume` ThresholdVolume
        - `fixed_value` string, int64, required — Value of the volume threshold.
    - `updated_at` string, date-time — Timestamp of when the ConsumptionBudget was last updated. Cannot be set by clients.
  - `page` Configv1PageResult
    - `next_token` string — An opaque page token that identifies the next page of items that the client should request. An empty value indicates that there are no more items to return.

## Other responses

- `500` — An unexpected error response.
- `default` — An undefined error response.

---

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