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

# Cards

> Create, list, inspect, and close virtual cards

Manage virtual cards with the `agent-cards cards` command group. Cards are funded from your [balance](/personal/cli/wallet) — add cash with `agent-cards fund` before creating your first card.

## Create a card

Amounts are in **US dollars, not cents**:

```bash theme={null}
agent-cards cards create --amount 25
```

| Option                      | Description                                                                                                            |
| --------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| `--amount <dollars>`        | **Required.** Amount in dollars (e.g. `25` = \$25.00).                                                                 |
| `--multi-use`               | Create a multi-use card: stays open across charges until its limit is spent (subscriptions).                           |
| `--preset <key>`            | Merchant-scope preset: `ai_labs` creates an AI card (AI-lab merchants only, boosted tokenback; implies `--multi-use`). |
| `--expires <iso>`           | Auto-close the multi-use card at this ISO-8601 time (at most 365 days out), e.g. `2027-01-01T00:00:00Z`.               |
| `--from <attached-card-id>` | Mint against a specific [attached card](#attach-your-own-card) (see `attach --list`).                                  |
| `-y, --yes`                 | Skip the confirmation prompt (for non-interactive / agent use).                                                        |
| `--json`                    | Output the result as JSON and run fully non-interactively.                                                             |

The amount must be within your plan's per-card cap ($50 Free / $500 Basic / \$1,000 Pro — see [Plans](/personal/plans)). The card draws on your cash balance when it's actually used. With an attached card, it charges that card directly instead.

## Attach your own card

Attach your own Visa card so new cards mint against it and purchases charge it directly, with no identity verification and no balance funding:

```bash theme={null}
agent-cards attach          # start the flow: a secure link (bank one-time code + passkey)
agent-cards attach --list   # show attached cards; the top active one is the default mint target
```

| Option          | Description                                                               |
| --------------- | ------------------------------------------------------------------------- |
| `--add`         | Attach another card alongside the current one (multi-card).               |
| `--replace`     | Remove the currently attached card first, then attach a new one.          |
| `--list`        | Show all attached cards (the top active card is the default mint target). |
| `--remove <id>` | Remove one attached card by id; virtual cards minted against it close.    |
| `--json`        | Machine-readable output (a single request, no browser or polling).        |

`agent-cards cards attach` is the same command. With more than one card attached, mint against a specific one with `cards create --from <attached-card-id>`. If your card isn't eligible (business cards, non-US cards, and some issuers are excluded), `cards create` keeps working the balance-funded way.

## List cards

```bash theme={null}
agent-cards cards list
```

Shows each card's ID, last four digits, expiry, balance, and status.

## Card details (PAN / CVV)

```bash theme={null}
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

```bash theme={null}
agent-cards balance <card-id>
```

A quick balance check without exposing the card credentials.

## Transactions

```bash theme={null}
agent-cards cards transactions <card-id>
```

| Option              | Description                                                                                  |
| ------------------- | -------------------------------------------------------------------------------------------- |
| `--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)

```bash theme={null}
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).

| Option              | Description                                                                                  |
| ------------------- | -------------------------------------------------------------------------------------------- |
| `--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

```bash theme={null}
agent-cards cards close <card-id>
```

Closing is permanent and releases any held funds. Pass `-y, --yes` to skip the confirmation prompt.