# List all budgets for a session.
Source:
GET
/v1/sessions/{session\_id}/budgets
Select code samplecURL (shell:curl)
```js
const url = 'https://app.everruns.com/api/v1/sessions/example/budgets';
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/sessions/example/budgets
```
* Production APIapp.everruns.com/api/v1/sessions/{session\_id}/budgets
## Parameters
### Path Parameters
**session\_id**
required
string
Prefixed public identifier
## Responses
### 200
Success
Media typeapplication/json
Array
Wrapper that adds API and UI links to a serialized resource.
Uses `self_url` (not `url`) for the API link to avoid collision with resources that already have a `url` field (e.g. McpServer). The `allowed_actions` array carries state-aware hypermedia links — empty (and omitted from the wire shape) until the underlying resource opts into the convention by overriding `ResourceUrlable::allowed_actions`.
object
**balance**
required
Current remaining balance (limit minus consumed).
number format: double
**created\_at**
required
string format: date-time
**currency**
required
Currency: “usd”, “tokens”, “credits”, or custom.
string
**id**
required
string
**limit**
required
Hard limit — budget ceiling.
number format: double
**metadata**
Arbitrary metadata.
**organization\_id**
required
string
**period**
One of:
* object
One of:
* object
Sliding window of a configurable number of seconds.
object
**seconds**
required
integer format: int64
**type**
required
string
Allowed values: duration
* object
Rolling window described as a humanized string (“5h”, “24h”, “30d”).
object
**type**
required
string
Allowed values: rolling
**window**
required
string
* object
Calendar-aligned (`hour`, `day`, `week`, `month`, `year`).
object
**type**
required
string
Allowed values: calendar
**unit**
required
string
* null
Sliding window of a configurable number of seconds.
object
**seconds**
required
integer format: int64
**type**
required
string
Allowed values: duration
* object
Rolling window described as a humanized string (“5h”, “24h”, “30d”).
object
**type**
required
string
Allowed values: rolling
**window**
required
string
* object
Calendar-aligned (`hour`, `day`, `week`, `month`, `year`).
object
**type**
required
string
Allowed values: calendar
**unit**
required
string
* object
null
**period\_started\_at**
When the current period started (used to detect period rollover for `Duration` / `Rolling` periods, and to display “resets at” in the UI). `None` for budgets without a period.
string | null format: date-time
**soft\_limit**
Soft limit — triggers pause/warn when balance drops below this.
number | null format: double
**status**
required
Budget status.
string
Allowed values: active paused exhausted disabled
**subject\_id**
required
Public ID of the subject entity.
string
**subject\_type**
required
Subject type: what entity this budget constrains.
string
Allowed values: session agent user organization agent\_trigger agent\_channel
**updated\_at**
required
string format: date-time
**allowed\_actions**
State-aware hypermedia actions the caller can take on this resource next (e.g. `cancel`, `events`, `update`). Omitted from the wire shape when empty so resources that haven’t opted into the convention don’t grow their payloads.
Array\