> ## 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, update, and delete cards.

These operations apply to both virtual and physical cards.

***

## Freeze and unfreeze

Freeze a card when the cardholder reports it as lost or at risk. A frozen card declines all transactions. You or the cardholder can freeze and unfreeze at any time.

Call [Freeze a card](/api-reference/cards/freeze-card) to suspend the card. Call [Unfreeze a card](/api-reference/cards/unfreeze-card) to restore it to `ACTIVE`.

***

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

***

## Blocked cards

Reap may block a card automatically when it detects suspicious activity, such as multiple failed PIN, CVV, or expiry attempts. A blocked card returns `status: BLOCKED` with a `blockReason` describing why.

Blocked cards cannot be unblocked via the API. Contact Reap support to review and unblock.
