---
title: "Get Balance"
method: GET
path: "/balance"
tags: ["Billing"]
---

# Get Balance

`GET /balance`

## Request

- Base URL: `https://api.hedra.com/v3`
- URL: `https://api.hedra.com/v3/balance`
- Auth: one of:
  - API key in header `Authorization`
  - HTTP bearer

## Response `200`

Successful Response

- BalanceResponse: Spendable balance on the account this key bills. Sourced from the workspace wallet for a workspace-bound key, else the caller's personal balance. While the segregated API wallet is enabled, both key types instead read the API wallet that generation debits draw on (a personal key resolves its bound workspace). Every amount is in US dollars.
  - `balance` number, required: Spendable balance.
  - `spent` number, nullable: Amount consumed in the current billing period; null for the non-expiring API wallet (see GET /v3/usage).
  - `currency` string, required: ISO-4217 currency code for every amount in this response.

## Other responses

- `400`: Invalid or failed-validation request.
- `401`: Authentication failed: missing, malformed, or invalid credentials.
- `403`: Insufficient scope or plan.
- `404`: Resource not found.
- `429`: Rate limit exceeded.
- `500`: Internal error.

## Changes

- **2026-10-16** `06692d16e78a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/hedra-labs/apis/hedra-api/changes/balance/get.md)

---

[API](https://skmtc.dev/hedra-labs/apis/hedra-api.md) - [All operations](https://skmtc.dev/hedra-labs/apis/hedra-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hedra-labs/apis/hedra-api/revisions/6ef35a11cefe?raw)