---
title: "Update a Card's PIN"
method: POST
path: "/cards/{card_id}/update_pin"
---

# Update a Card's PIN

`POST /cards/{card_id}/update_pin`

## Path parameters

- `card_id` string, required — The identifier of the Card to update the PIN for.

## Request body

- UpdateACardsPinParameters
  - `pin` string, required — The 4-digit PIN for the card, for use with ATMs.

## Response `200`

Card Details

- CardDetails — An object containing the sensitive details (card number, CVC, PIN, etc) for a Card. These details are not included in the Card object. If you'd prefer to never access these details directly, you can use the [embedded iframe](/documentation/embedded-card-component) to display the information to your users.
  - `card_id` string, required — The identifier for the Card for which sensitive details have been returned.
  - `expiration_month` integer, required — The month the card expires in M format (e.g., August is 8).
  - `expiration_year` integer, required — The year the card expires in YYYY format (e.g., 2025).
  - `pin` string, required — The 4-digit PIN for the card, for use with ATMs.
  - `primary_account_number` string, required — The card number.
  - `type` 'card_details', required — A constant representing the object's type. For this resource it will always be `card_details`.
  - `verification_code` string, required — The three-digit verification code for the card. It's also known as the Card Verification Code (CVC), the Card Verification Value (CVV), or the Card Identification (CID).

## Other responses

- `4XX` — Error
- `5XX` — Error

---

[API](https://skmtc.net/increase/apis/increase-api-2.md) · [All operations](https://skmtc.net/increase/apis/increase-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/increase/increase-api-2/versions/cc76869b968b/schema)