> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qonto.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Cards

> List, create, and manage Qonto cards

List the organization's cards, create new ones, and manage their lifecycle, limits, options, and restrictions.

| Command                                | What it does                                                                                           | OAuth scope  |
| -------------------------------------- | ------------------------------------------------------------------------------------------------------ | ------------ |
| `qonto cards appearances`              | [List card appearances](/api-reference/business-api/cards/list-appearances)                            | `card.read`  |
| `qonto cards bulk-create`              | [Bulk create cards](/api-reference/business-api/cards/bulk-create-cards)                               | `card.write` |
| `qonto cards create`                   | [Create a card](/api-reference/business-api/cards/create-a-card)                                       | `card.write` |
| `qonto cards data-view <id>`           | [Retrieve a card iframe url](/api-reference/business-api/cards/retrieve-a-card-iframe-url)             | `card.read`  |
| `qonto cards discard <id>`             | [Discard a card](/api-reference/business-api/cards/discard-a-card)                                     | `card.write` |
| `qonto cards list`                     | [List cards](/api-reference/business-api/cards/list-cards)                                             | `card.read`  |
| `qonto cards lock <id>`                | [Lock a card](/api-reference/business-api/cards/lock-a-card)                                           | `card.write` |
| `qonto cards report-lost <id>`         | [Report a physical card as lost](/api-reference/business-api/cards/report-a-physical-card-as-lost)     | `card.write` |
| `qonto cards report-stolen <id>`       | [Report a physical card as stolen](/api-reference/business-api/cards/report-a-physical-card-as-stolen) | `card.write` |
| `qonto cards unlock <id>`              | [Unlock a card](/api-reference/business-api/cards/unlock-a-card)                                       | `card.write` |
| `qonto cards update-limits <id>`       | [Update a card's limits](/api-reference/business-api/cards/update-a-cards-limits)                      | `card.write` |
| `qonto cards update-nickname <id>`     | [Update a card's nickname](/api-reference/business-api/cards/update-a-cards-nickname)                  | `card.write` |
| `qonto cards update-options <id>`      | [Update a card's options](/api-reference/business-api/cards/update-a-cards-options)                    | `card.write` |
| `qonto cards update-restrictions <id>` | [Update a card's restrictions](/api-reference/business-api/cards/update-a-cards-restrictions)          | `card.write` |

`cards create`, `cards bulk-create`, `cards update-limits`, and `cards update-restrictions` take their request as a JSON document with `--body`, because its shape depends on the card level. The fields are described on each command's API reference page.

<Note>
  Creating a physical card, and some changes to an existing card, require [Strong Customer Authentication](/cli/usage#strong-customer-authentication): the command waits until you approve in the Qonto app. Reporting a card as lost or stolen, and discarding it, cannot be undone.
</Note>

**Try it**

```bash theme={null}
# Active virtual cards
qonto cards list --card-levels virtual --statuses live --fields id,nickname,last_digits

# Lock a card, then unlock it
qonto cards lock <card-id>
qonto cards unlock <card-id>

# Online payments only
qonto cards update-options <card-id> --online-option \
  --atm-option=false --nfc-option=false --foreign-option=false

# Create a card from a JSON document
qonto cards create --body @card.json
```

`qonto cards data-view` returns a short-lived link that shows the card number, expiry date, and CVV. Treat it like a password.