---
title: "Get Balance"
method: GET
path: "/v1/workspaces/{workspace}/balance"
tags: ["v1", "protected", "dashboard"]
---

# Get Balance

`GET /v1/workspaces/{workspace}/balance`

## Request

- The document declares no server URL.
- Auth: HTTP bearer

The balance of the account paying for this workspace; null when the deployment sells none.

## Path parameters

- `workspace` string, required: Slug of the workspace the request acts in

## Response `200`

Successful Response

- BalanceResponse
  - `amount` string, nullable, required
  - `currency` string, required
  - `exhausted` boolean, required
  - `runway_days` string, nullable
  - `spend_per_day` string, nullable
  - `viewer_is_payer` boolean, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-31** `5b651833a114`: 2 info
  - added the optional property `anyOf[subschema #1: BalanceResponse]/runway_days` to the response with the `200` status
  - added the optional property `anyOf[subschema #1: BalanceResponse]/spend_per_day` to the response with the `200` status
- **2026-10-22** `a29aeac525df`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/agentarea/apis/agentarea-api/changes/v1/workspaces/:workspace/balance/get.md)

---

[API](https://skmtc.dev/agentarea/apis/agentarea-api.md) - [All operations](https://skmtc.dev/agentarea/apis/agentarea-api/llms.txt) - [OpenAPI document](https://skmtc.dev/agentarea/apis/agentarea-api/revisions/5b651833a114?raw)