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

# Card lifecycle

> Card statuses from pending to terminated, and how to freeze, unfreeze, terminate or replace a lost, stolen or damaged card.

Every card has a `status` that decides whether it can be used. You change it with dedicated endpoints rather than by updating the card.

| Status | Meaning |
| - | - |
| `pending` | The card is created but cannot be used yet. Physical cards stay `pending` until delivery. |
| `active` | The card can be used. |
| `frozen` | New authorizations are declined. Refunds and already authorized payments still go through. |
| `terminated` | The card is closed permanently. |

```mermaid theme={null}
stateDiagram-v2
  [*] --> pending
  pending --> active
  active --> frozen: freeze
  frozen --> active: unfreeze
  active --> terminated: terminate
  frozen --> terminated: terminate
  terminated --> [*]
```

## Freeze and unfreeze

Use freeze when a cardholder misplaces a card or you need to pause spending.

```bash theme={null}
curl -X POST https://api.pointzero.io/v1/cards/card_01JZ8N2K4M/freeze \
  -H "Authorization: Bearer $POINTZERO_API_KEY"
```

Call [unfreeze](/api-reference/cards/unfreeze-a-card) to make it `active` again.

## Terminate

[Terminate](/api-reference/cards/terminate-a-card) closes the card. This cannot be undone. Wallet tokens linked to the card are removed.

## Replace

[Replace a card](/api-reference/cards/replace-a-card) issues a new card for the same customer and copies its spending and authorization controls. The new card has `replaced_card_id` set to the old card.

| `reason` | Old card |
| - | - |
| `lost`, `stolen` | Always terminated |
| `damaged`, `expired`, `other` | Terminated unless `terminate_existing` is `false` |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.