Skip to content
Everruns Cloud is open in early access. Run agents without operating the platform.

Check all budgets for a session.

GET
/v1/sessions/{session_id}/budget-check
curl --request GET \
--url https://app.everruns.com/api/v1/sessions/example/budget-check
session_id
required
string

Prefixed public identifier

Success

Media typeapplication/json

Result of checking all budgets for a session.

object
action
required

Most restrictive action across all budgets.

string
balance

Remaining balance on the most restrictive budget.

number | null format: double
budget_id

Budget that triggered the action.

string | null
currency

Currency of the most restrictive budget.

string | null
error_code

Stable error code for user-facing budget failures.

string | null
error_fields

Structured interpolation fields for localized error rendering.

object | null
message

Human-readable message (set when action != “continue”).

string | null
Examplegenerated
{
"action": "example",
"balance": 1,
"budget_id": "example",
"currency": "example",
"error_code": "example",
"error_fields": "example",
"message": "example"
}