# List ledger entries for a budget.

Source: <https://everruns.com/docs/api/operations/list_budget_ledger/>

GET

/v1/budgets/{budget\_id}/ledger

Select code samplecURL (shell:curl)

```js
const url = 'https://app.everruns.com/api/v1/budgets/example/ledger';
const options = {method: 'GET'};


try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

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

* Production APIapp.everruns.com/api/v1/budgets/{budget\_id}/ledger

## 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

##### Examplegenerated

```json
[
  {
    "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"
  }
]
```