---
title: "Get Budget Suggestions"
method: GET
path: "/api/budgets/suggestions"
tags: ["Budgets"]
---

# Get Budget Suggestions

`GET /api/budgets/suggestions`

## Request

- Base URL: `https://api.earmarkiq.app` (the document declares no server; this is the origin it was published from)
- URL: `https://api.earmarkiq.app/api/budgets/suggestions`
- Auth: HTTP bearer

Budget suggestions from spending history. A user on BEHAVIOUR_V2 gets
the budget engine's (EQ-72: never a fixed cost, flexible categories only,
sized from their own pay cycles); everyone else the v1 logic unchanged.

## Response `200`

Successful Response

- BudgetSuggestion[]
  - `category` string, required
  - `suggested_limit` number, required
  - `current_limit` number, nullable
  - `average_spend` number, required
  - `explanation` string, required
  - `suggestion_type` string, required

---

[API](https://skmtc.dev/earmarkiq/apis/earmark-api.md) · [All operations](https://skmtc.dev/earmarkiq/apis/earmark-api/llms.txt) · [OpenAPI document](https://skmtc.dev/earmarkiq/apis/earmark-api/revisions/4a2c41907105?raw)