get_card_balance
Read-onlyIdempotent
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.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"card_id": "<card_id>"
},
"name": "get_card_balance"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| card_id | Yes | The card ID |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cached | No | Whether the balance was served from a short-lived cache rather than fetched live. | |
| message | Yes | Human-readable balance summary. | |
| balanceCents | No | Available balance in cents. | |
| balanceDollars | No | Available balance formatted as USD dollars, e.g. "12.50". |