# POST /debit/api/replaceCard

**Resource:** [Card lifecycle](../resources/Card-lifecycle.md)
**Card renewal service**
**Operation ID:** `replaceCard`

Replaces an existing card with a new one. Accepts details such as card emboss reason, product number, delivery information, and optional permissions. Returns the new card information, including masked number, shadow card number, and any warnings.

## Request Body

Replace Card Request

**Required:** Yes

**Content Types:** `application/json`

**Schema:** [ReplaceCardRequest](../schemas/Replace/ReplaceCardRequest.md)

## Responses

| Status | Description |
|--------|-------------|
| 200 | Success |
| 400 | (reference) |
| 404 | (reference) |
| 500 | (reference) |

**Success Response Schema:**

[ReplaceCardResponse](../schemas/Replace/ReplaceCardResponse.md)

