---
title: "Read this card's available spending balance and reserved funds, in micro-USD."
method: POST
path: "/v1/balance"
---

# Read this card's available spending balance and reserved funds, in micro-USD.

`POST /v1/balance`

## Request

- Base URL: `http://localhost:5100`
- URL: `http://localhost:5100/v1/balance`
- Auth: HTTP bearer

## Request body

- object
  - `cardId` string, uuid: Card to use. Required when this connection has multiple cards. List cards first.

## Response `200`

Operation result. An invocation may still be pending; inspect its state.

- object
  - `availableMicros` string, required
  - `reservedMicros` string, required
  - `status` 'active' | 'suspended' | 'archived', required
  - `spending` object
    - `mode` 'available' | 'free_only' | 'blocked', required
    - `reason` 'wallet_inactive' | 'wallet_debt' | 'wallet_unfunded' | 'allowance_inactive' | 'allowance_unavailable' | 'allowance_exhausted' | 'allowance_exceeded' | 'hierarchy_invalid'
  - `execution` object
    - `ready` boolean, required
    - `reason` 'runtime_upgrade_required'

## Other responses

- `400`: Rejected request or temporary failure. See the errors and limits guide.
- `402`: Rejected request or temporary failure. See the errors and limits guide.
- `403`: Rejected request or temporary failure. See the errors and limits guide.
- `404`: Rejected request or temporary failure. See the errors and limits guide.
- `409`: Rejected request or temporary failure. See the errors and limits guide.
- `503`: Rejected request or temporary failure. See the errors and limits guide.

---

[API](https://skmtc.dev/o11/apis/o11-wallet-api.md) - [All operations](https://skmtc.dev/o11/apis/o11-wallet-api/llms.txt) - [OpenAPI document](https://skmtc.dev/o11/apis/o11-wallet-api/revisions/2071972de71c?raw)