---
title: "Check daily budget"
method: GET
path: "/api/burnrate/budget"
tags: ["BurnRate"]
---

# Check daily budget

`GET /api/burnrate/budget`

## Request

- Base URL: `https://plith.ai`
- URL: `https://plith.ai/api/burnrate/budget`
- Auth: none required

Returns today's tracked LLM spend, per-model breakdown, hourly burn rate, projected day total, and optional budget alerts. FREE — no credit deduction.

## Query parameters

- `daily_limit` number

## Response `200`

Daily budget status

- object
  - `date` string, date
  - `spend` object
    - `total_usd` number
    - `total_usd_formatted` string
    - `total_calls` integer
    - `by_model` object[]
      - `model` string
      - `usd` number
      - `usd_formatted` string
      - `calls` integer
  - `budget` object, nullable: Present only when daily_limit query param is provided.
    - `daily_limit_usd` number
    - `remaining_usd` number
    - `remaining_usd_formatted` string
    - `utilization_pct` integer
  - `projection` object
    - `hourly_rate_usd` number
    - `projected_day_total_usd` number
    - `projected_day_total_usd_formatted` string
    - `hours_remaining` number
  - `alerts` string[]: Budget threshold warnings. Populated when daily_limit is set and thresholds are crossed.
  - `cross_product` object
  - `request_id` string
  - `credits_used` integer
  - `credits_remaining` integer
  - `fallback_behavior` string

## Other responses

- `400`: Invalid daily_limit parameter
- `401`: Invalid or missing API key
- `500`: Internal server error

---

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