Error

A valid request URL is required to generate request examples

{
  "usage": {
    "window": {
      "start_date": "2026-06-24",
      "end_date": "2026-07-23"
    },
    "display": "amount",
    "totals": {
      "spend": 0.42,
      "prompt_tokens": 18000,
      "completion_tokens": 3200,
      "total_tokens": 21200,
      "successful_requests": 14,
      "failed_requests": 0,
      "api_requests": 14
    },
    "daily": [
      {
        "date": "2026-07-22",
        "spend": 0.42,
        "prompt_tokens": 18000,
        "completion_tokens": 3200,
        "total_tokens": 21200,
        "successful_requests": 14,
        "failed_requests": 0,
        "api_requests": 14
      }
    ],
    "byModel": [
      {
        "model": "gpt-4o",
        "spend": 0.42,
        "prompt_tokens": 18000,
        "completion_tokens": 3200,
        "total_tokens": 21200,
        "successful_requests": 14,
        "failed_requests": 0
      }
    ]
  }
}

Budgets

Get my usage details

Returns the calling user’s LiteLLM spend and token usage for the requested date window — totals, per-day breakdown, and per-model breakdown. The window defaults to the last 30 days ending today (UTC) and is capped at 92 days. Gated by the admin show_user_budget_in_chat setting: when the setting is off, usage is null and no spend data is surfaced. Requires authentication; returns 401 for unauthenticated callers. Returns 502 when LiteLLM is unreachable.

GET

usage

Error

A valid request URL is required to generate request examples

{
  "usage": {
    "window": {
      "start_date": "2026-06-24",
      "end_date": "2026-07-23"
    },
    "display": "amount",
    "totals": {
      "spend": 0.42,
      "prompt_tokens": 18000,
      "completion_tokens": 3200,
      "total_tokens": 21200,
      "successful_requests": 14,
      "failed_requests": 0,
      "api_requests": 14
    },
    "daily": [
      {
        "date": "2026-07-22",
        "spend": 0.42,
        "prompt_tokens": 18000,
        "completion_tokens": 3200,
        "total_tokens": 21200,
        "successful_requests": 14,
        "failed_requests": 0,
        "api_requests": 14
      }
    ],
    "byModel": [
      {
        "model": "gpt-4o",
        "spend": 0.42,
        "prompt_tokens": 18000,
        "completion_tokens": 3200,
        "total_tokens": 21200,
        "successful_requests": 14,
        "failed_requests": 0
      }
    ]
  }
}

Authorizations

x-api-key

string

header

required

Organisation API key. Format: sk_<secret>/<keyname> — the secret portion, a literal slash, and the human-readable key name. The header exulu-api-key is accepted as an alias. A Bearer prefix is tolerated and stripped. Keys with an agent scope are only valid for the scoped agent instance.

Query Parameters

start_date

string

Start of the window. Accepts YYYY-MM-DD or an ISO datetime string. Defaults to 30 days before end_date.

end_date

string

End of the window. Accepts YYYY-MM-DD or an ISO datetime string. Defaults to today (UTC).

Response

Usage view for the requested window, or null when spend data is hidden by the admin.

usage

object | null

required

null when show_user_budget_in_chat is disabled or the user has no LiteLLM budget tag.

Show child attributes

Get LiteLLM tag-activity analytics

Download the bootstrap skill

REST

GraphQL

Core types

Get my usage details

Authorizations

Query Parameters

Response