Skip to main content
Manage virtual cards with the agent-cards cards command group. Cards are funded from your wallet balance — add funds with agent-cards wallet fund before creating your first card.

​
Create a card

Amounts are in US dollars, not cents: 
agent-cards cards create --amount 25
OptionDescription
--amount <dollars>Required. Amount in dollars (e.g. 25 = $25.00).
-y, --yesSkip the confirmation prompt (for non-interactive / agent use).
--jsonOutput the result as JSON and run fully non-interactively.
The amount must be within your plan’s per-card cap (50Free/50 Free / 500 Basic / $1,000 Pro — see Plans). The card draws on your wallet balance when it’s actually used.

​
List cards

agent-cards cards list
Shows each card’s ID, last four digits, expiry, balance, and status.

​
Card details (PAN / CVV)

agent-cards cards details <card-id>
Returns the decrypted full card number, CVV, and expiry — use this to fill a payment form. Only run it when you actually need the credentials.

​
Balance

agent-cards balance <card-id>
A quick balance check without exposing the card credentials.

​
Transactions

agent-cards cards transactions <card-id>
OptionDescription
--limit <n>Number of transactions (default 20).
--status <status>Filter by status (e.g. PENDING, SETTLED, DECLINED, REVERSED, EXPIRED, REFUNDED).
agent-cards transactions <card-id> is a top-level alias for the same per-card command.

​
All transactions (account-wide)

agent-cards transactions
Run transactions with no card id to list every transaction across all of your cards in one flat list. Each row shows which card it belongs to (last 4).
OptionDescription
--limit <n>Number of transactions (default 20, max 100).
--offset <n>Number of transactions to skip, for pagination.
--status <status>Filter by status (e.g. PENDING, SETTLED, DECLINED, REVERSED, EXPIRED, REFUNDED).

​
Close a card

agent-cards cards close <card-id>
Closing is permanent and releases any held funds. Pass -y, --yes to skip the confirmation prompt.