> ## 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"
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.