List ledger entries for a budget.

GET

/v1/budgets/{budget_id}/ledger

curl --request GET \
  --url https://app.everruns.com/api/v1/budgets/example/ledger

• Production API

Parameters

Path Parameters

budget_id

required

string

Prefixed public identifier

Query Parameters

limit

integer format: int64

Maximum number of items returned in this page.

offset

integer format: int64

Zero-based offset into the result set.

Responses

200

Success

Media typeapplication/json

Array<object>

Immutable platform ledger record for resource consumption or credit.

object

amount

required

Positive = debit (consumption), negative = credit (top-up/refund).

number format: double

budget_id

required

string

created_at

required

string format: date-time

description

string | null

id

required

string

meter_source

required

Which meter produced this: “llm_tokens”, “tool_calls”, etc.

string

ref_id

Reference entity ID.

string | null

ref_type

Reference entity type: “llm_generation”, “tool_execution”, “manual”.

string | null

session_id

Session context for this entry.

string | null

Example^generated

[
  {
    "amount": 1,
    "budget_id": "example",
    "created_at": "2026-04-15T12:00:00Z",
    "description": "example",
    "id": "example",
    "meter_source": "example",
    "ref_id": "example",
    "ref_type": "example",
    "session_id": "example"
  }
]