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

# Managing Cards

> Freeze, block, update, and delete cards.

These operations apply to both virtual and physical cards.

***

## Freeze and unfreeze

Freeze a card when the cardholder misplaces it or wants to pause spending. Call [Freeze a card](/api-reference/cards/freeze-card), and [Unfreeze a card](/api-reference/cards/unfreeze-card) to restore it. Either is available to you at any time.

A frozen card declines everything, including in-store and ATM use of a physical card and any mobile wallet it has been added to.

Freeze is the soft toggle. When you need a hard stop, block the card instead. See [freeze and block](/cards/overview#freeze-and-block-are-separate) for the difference.

***

## Block and unblock

Block a card when it needs a hard stop: the cardholder reports it compromised, a dispute is open, or you are holding the account pending review. Call [Block a card](/api-reference/cards/block-card). The card returns `status: BLOCKED` with `blockReason.type: CLIENT_REQUESTED`.

Call [Unblock a card](/api-reference/cards/unblock-card) to lift it. Read `blockLiftable` on the card first: a block Reap placed for risk or compliance reports `false` and returns `409 CARD_BLOCK_NOT_LIFTABLE`. See [blocked cards](/cards/overview#blocked-cards) for every reason, who can lift it, and what happens to a freeze the block was hiding.

***

## Update PIN

Call [Update PIN](/api-reference/cards/update-card-pin) to set or change the cardholder's PIN. The PIN is used for ATM withdrawals and at POS terminals that require chip-and-PIN verification.

PIN requirements:

* 4–12 digits
* No 3 or more consecutive ascending digits (e.g. `123`, `234`)
* No 3 or more repeated digits (e.g. `111`, `555`)

***

## Delete a card

Call [Delete a card](/api-reference/cards/delete-card) to delete a card when offboarding a user or closing their card program. Deletion is irreversible via the API.

***

## List cards

Call [List cards](/api-reference/cards/list-cards) to retrieve cards for your project. Use the `accountId` filter to scope results to a specific user's account. This is the most common use case when showing a cardholder their own cards.