---
title: "Retrieve a PIN"
method: GET
path: "/cards/{cardId}/pin"
tags: ["PIN"]
---

# Retrieve a PIN

`GET /cards/{cardId}/pin`

Returns the PIN for a given card.

## Path parameters

- `cardId` string, uuid, required — The ID of the card to work with.

## Query parameters

- `accountId` string, required — The ID of the account to work with.
- `personId` string, uuid, required — The ID of the person to work with.
- `cardholderVerificationMethod` 'BIOMETRIC_FACE' | 'BIOMETRIC_FINGERPRINT' | 'LOGIN' | 'OTP', required — The supplemental method used to verify the cardholder’s identity before revealing the card’s PIN.
- `sessionId` string — The MFA session id.
- `token` string — The security token e.g. MFA code.

## Response `200`

OK

- object
  - `pin` string, nullable, required — the PIN of the card.

---

[API](https://skmtc.net/equalsmoney/apis/cis-api.md) · [All operations](https://skmtc.net/equalsmoney/apis/cis-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/equalsmoney/cis-api/revisions/a162c72b8bf6/schema)
