/ Guides / Cards / Tutorial / Retrieve a card's PIN

Step 1: retrieve a card's PIN

You can use the API to retrieve a card's PIN as needed, for example if a customer has forgotten theirs. Note that you'll need to ask the cardholder to verify their identity with you and log this verification method in your request.

curl -i -X GET \
  'https://api-sandbox.equalsmoney.com/v2/cards/{cardId}/pin?accountId={accountId}&personId={personId}&cardholderVerificationMethod={cardholderVerificationMethod}' \
  -H 'Authorization: ApiKey {apiKey}'

curl -i -X GET \
  'https://api.equalsmoney.com/v2/cards/{cardId}/pin?accountId={accountId}&personId={personId}&cardholderVerificationMethod={cardholderVerificationMethod}' \
  -H 'Authorization: ApiKey {apiKey}'

If your request is successful, you'll receive a 200 response containing only the PIN.

{
  "pin": "7152"
}

Next