---
title: "Get budget alerts"
method: GET
path: "/api/v1/budgets/{id}/alerts"
tags: ["Cost Controls"]
---

# Get budget alerts

`GET /api/v1/budgets/{id}/alerts`

## Request

- Base URL: `https://orchestrator.getaxonflow.com`
- URL: `https://orchestrator.getaxonflow.com/api/v1/budgets/{id}/alerts`
- Auth: none declared
- TypeScript: <https://skmtc.dev/getaxonflow/apis/axonflow-orchestrator-api/docs/api/v1/budgets/:id/alerts/get.ts> (a function with typed inputs; its response is checked against the schema)

Get alerts triggered for a specific budget.

Enterprise only. These routes are not registered in Community
edition, which returns 404 Not Found.

## Path parameters

- `id` string, required

## Query parameters

- `limit` integer

## Response `200`

Budget alerts

- BudgetAlertList
  - `alerts` BudgetAlert[]
    - `id` integer
    - `budget_id` string
    - `threshold` integer: Threshold percentage that triggered alert
    - `percentage_reached` number, double
    - `amount_usd` number, double
    - `alert_type` 'threshold_reached' | 'budget_exceeded' | 'budget_blocked'
    - `message` string
    - `created_at` string, date-time
    - `acknowledged` boolean
  - `count` integer

## Other responses

- `404`: Budget not found

---

[API](https://skmtc.dev/getaxonflow/apis/axonflow-orchestrator-api.md) - [All operations](https://skmtc.dev/getaxonflow/apis/axonflow-orchestrator-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getaxonflow/apis/axonflow-orchestrator-api/revisions/f408ef3ec9dd?raw)