---
title: "List budget suggestions"
method: GET
path: "/analytics/v1/budget-suggestions"
tags: ["Budget Suggestions"]
---

# List budget suggestions

`GET /analytics/v1/budget-suggestions`

Returns the pending AI-generated budget suggestions for your account. The set is small (a handful
of pending suggestions) and is returned in full. Each suggestion can be accepted (after you create a
matching budget via `POST /analytics/v1/budgets`) or dismissed.

## Response `200`

OK - The request succeeded.

- object
  - `items` BudgetSuggestion[] — Array of pending budget suggestions.
    - `id` string
    - `name` string
    - `description` string
    - `rationale` string — Explanation of why this budget is suggested.
    - `confidence` 'high' | 'medium' | 'low'
    - `amount` object — Suggested budget amount as a decimal-string value with its currency.
      - `amount` string — Decimal string, e.g. "1234.56".
      - `currency` string
    - `timeInterval` string
    - `alertThresholds` number[] — Suggested alert thresholds as percentages of the amount.
    - `scopeChips` object[] — Human-readable summary of the suggested budget scope.
      - `key` string
      - `values` string[]
    - `config` object — Draft budget configuration to merge over the create-budget defaults.
    - `generatedTime` string, date-time — Timestamp when the suggestion was generated.
    - `status` 'pending' | 'accepted' | 'dismissed' | 'skippedDraft'
  - `rowCount` integer — Number of suggestions returned.

## Other responses

- `401` — Unauthorized - Invalid API key.
- `403` — Forbidden - The client is not authorized to perform the request.
- `500` — Internal Server Error - Something went wrong with the DoiT API server.

---

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