> ## 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.

# check_balance

> Check the live balance on a virtual card

Checks the available balance for one card. Prefer this over `get_card_details` when you only need to verify funds; it is faster and never exposes card credentials.

## Parameters

| Parameter | Type   | Required | Description |
| --------- | ------ | -------- | ----------- |
| `card_id` | string | Yes      | The card ID |

## Returns

A short balance summary plus `balanceCents` and `balanceDollars`. A `cached` flag tells you when the number came from a short-lived cache rather than a live fetch.

## Example

```json theme={null}
{ "name": "check_balance", "arguments": { "card_id": "card_abc123" } }
```