> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentcard.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# get_card_balance

> The live balance of ONE virtual card (the user's overall cash balance is get_balance).

Connect to `https://mcp.agentcard.sh/mcp` with the **user's connection token** (or a `buy_token` for org-owned accounts).

**Behavior:** read-only, idempotent.

## What it does

The live balance of ONE virtual card (the user's overall cash balance is get\_balance). Prefer this over get\_card\_details when you only need to verify available funds: it is faster and does not expose sensitive card credentials.

## Inputs

| Field                  | Type   | Description |
| ---------------------- | ------ | ----------- |
| `card_id` *(required)* | string | The card ID |

## Returns

| Field                  | Type    | Description                                                                       |
| ---------------------- | ------- | --------------------------------------------------------------------------------- |
| `message` *(required)* | string  | Human-readable balance summary.                                                   |
| `balanceCents`         | number  | Available balance in cents.                                                       |
| `balanceDollars`       | string  | Available balance formatted as USD dollars, e.g. "12.50".                         |
| `cached`               | boolean | Whether the balance was served from a short-lived cache rather than fetched live. |

## Example call

```json theme={null}
{
  "tool": "get_card_balance",
  "arguments": {
    "card_id": "\u2026"
  }
}
```