---
title: "List budgets"
method: GET
path: "/analytics/v1/budgets"
tags: ["Budgets"]
---

# List budgets

`GET /analytics/v1/budgets`

Returns a list of budgets that your account has access to. Budgets are listed in reverse chronological order by default.

## Query parameters

- `maxResults` string
- `pageToken` string
- `filter` string
- `minCreationTime` string
- `maxCreationTime` string

## Response `200`

OK - The request succeeded.

- object
  - `budgets` BudgetListItem[] — Array of Budgets
    - `alertThresholds` AlertThreshold[]
      - `amount` number, double
      - `percentage` number, double
    - `amount` number, double
    - `budgetName` string
    - `createTime` integer
    - `currency` string
    - `currentUtilization` number, double
    - `endPeriod` integer
    - `forecastedUtilizationDate` integer
    - `id` string
    - `owner` string
    - `scope` string[] — List of allocations that define the budget scope.
    - `scopes` ExternalConfigFilter[] — The filters selected define the scope of the budget.
      - `id` string, required — Dimension key to filter on. Must pair with `type` and match a dimension returned by `GET /analytics/v1/dimensions` (for example, `service_description` with `type: fixed`). For `allocation_rule`, use `allocation_rule`. For `allocation`, use the allocation group ID. See `DimensionsTypes` for how each `type` uses `id`.
      - `type` 'datetime' | 'fixed' | 'optional' | 'label' | 'tag' | 'project_label' | 'system_label' | 'attribution' | 'attribution_group' | 'allocation' | 'allocation_rule' | 'gke' | 'gke_label', required — Dimension filter type. Always pair `type` with `id` on scope filters. Discover valid `id` + `type` pairs for your account with `GET /analytics/v1/dimensions`. `allocation_rule` replaces `attribution`; `allocation` replaces `attribution_group`.
      - `values` string[] — List of values to include or exclude. Must match exact strings from your billing or DataHub data for the dimension (for example, `Amazon Simple Storage Service` for AWS S3 on `service_description`). For `allocation_rule`, use allocation rule IDs.
      - `mode` 'is' | 'starts_with' | 'ends_with' | 'contains' | 'regexp' — Controls how the dimension’s `values` are matched when the alert query runs. If mode is omitted, behavior defaults to is.
      - `inverse` boolean — Set to `true` to exclude the set values. If inverse is omitted, behavior defaults to `false`.
      - `caseInsensitive` boolean — If true, string matching is case-insensitive. Effective only for starts_with, ends_with, and contains modes; ignored otherwise.
      - `includeNull` boolean — Include rows where the dimension is null. If includeNull is omitted, behavior defaults to `false`.
    - `startPeriod` integer
    - `timeInterval` string
    - `updateTime` integer
    - `url` string
  - `pageToken` string — Page token, returned by a previous call, to request the next page of results
  - `rowCount` integer — Budgets rows count

## Other responses

- `400` — Bad Request - The server cannot process the request, often due to a malformed request.
- `401` — Unauthorized - Invalid API key.
- `403` — Forbidden - The client is not authorized to perform the request.
- `404` — Not Found - The requested resource does not exist.

---

[API](https://skmtc.dev/doit/apis/doit-cloud-intelligence.md) · [All operations](https://skmtc.dev/doit/apis/doit-cloud-intelligence/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/doit/doit-cloud-intelligence/revisions/9416402fc119/schema)