get_card
Get the user's Picnic cards (Gnosis Pay): card type, masked last four digits, status flags, balances, allowances, and the smart-account address backing each card.
Sensitive PAN/CVV/expiry are never returned by this tool — those require an in-app passkey ceremony.
Required scope: read:card
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
card_type | enum | no | virtual, physical, or all (default). |
include_void | boolean | no | Include voided/closed cards. Defaults to false (active and frozen cards only). |
Returned fields (per card):
| Field | Type | Description |
|---|---|---|
cardId | string | null | Internal card identifier. |
cardName | string | null | Optional user-set card label. |
cardType | enum | virtual or physical. |
lastFourDigits | string | null | Masked last four PAN digits. |
isActivated | boolean | True if the card has been activated. |
activatedAt | date | null | Activation timestamp. |
isFrozen | boolean | Card frozen by user or system. |
isStolen, isLost, isBlocked, isVoid | boolean | Status flags. |
accountBalances.total | string | null | Total Safe balance — decimal-formatted in the settlement token (e.g. "32.266959161447336568" EURe). String, like formattedAmount in get_balances. |
accountBalances.spendable | string | null | Spendable balance (settled, not earmarked). |
accountBalances.pending | string | null | Pending balance (in-flight settlements). |
allowances.refill | string | null | Refill amount per period — decimal-formatted in the settlement token. |
allowances.maxRefill | string | null | Maximum refill amount per period. |
allowances.balance | string | null | Current allowance balance remaining. |
allowances.period | string | null | Refill period in seconds (Unix duration). |
allowances.timestamp | string | null | Last refill — Unix timestamp in seconds. |
fiatSymbol | "EUR" | "USD" | "GBP" | Card's fiat currency. |
tokenSymbol | string | Settlement token symbol (e.g. EURe, USDC). |
tokenAssetId | string | null | CAIP (opens in a new tab)-style asset identifier for the settlement token (e.g. eip155:100/erc20:0x420C…). Cross-references the same token in get_balances. |
smartAccountAddress | string | Address of the Gnosis Pay smart account backing the card. |
chainId | number | Chain the card account lives on. |
delayModuleLockedUntil | date | null | If a delay-module change is queued, when it unlocks. |
accountBalances is shared across all cards on the same smartAccountAddress — virtual and physical cards on one Safe spend from the same balance, so the populated value is propagated to sibling cards.
Example prompt:
"Is my card frozen, and what's my available balance?"