---
title: "POST /card/change-pin"
method: POST
path: "/card/change-pin"
tags: ["Card Resource"]
---

# POST /card/change-pin

`POST /card/change-pin`

## Request

- The document declares no server URL.
- Auth: none declared
- TypeScript: <https://skmtc.dev/ere-health/apis/ere-ps-app-api/docs/card/change-pin/post.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- ChangePinParameter
  - `cardHandle` string
  - `pinType` string

## Response `200`

OK

- ChangePinResponse
  - `status` Status
    - `result` string
    - `error` Error
      - `messageID` string
      - `timestamp` XMLGregorianCalendar
        - `year` integer
        - `month` integer
        - `day` integer
        - `timezone` integer
        - `hour` integer
        - `minute` integer
        - `second` integer
        - `millisecond` integer
        - `fractionalSecond` number
        - `eon` integer
        - `eonAndYear` integer
        - `xMLSchemaType` QName
          - `namespaceURI` string
          - `localPart` string
          - `prefix` string
        - `valid` boolean
      - `trace` Trace[]
        - `eventID` string
        - `instance` string
        - `logReference` string
        - `compType` string
        - `code` integer
        - `severity` string
        - `errorType` string
        - `errorText` string
        - `detail` Detail
          - `value` string
          - `encoding` string
  - `pinResultEnum` 'ERROR' | 'OK' | 'REJECTED' | 'WASBLOCKED' | 'NOWBLOCKED' | 'TRANSPORT_PIN'
  - `leftTries` integer

## Changes

- **2026-07-17** `d32d3faa5345`: 1 info
  - endpoint added
  - …this revision’s changelog is incomplete
- **2021-10-07** `b1e6af7e0bf2`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/ere-health/apis/ere-ps-app-api/changes/card/change-pin/post.md)

---

[API](https://skmtc.dev/ere-health/apis/ere-ps-app-api.md) - [All operations](https://skmtc.dev/ere-health/apis/ere-ps-app-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ere-health/apis/ere-ps-app-api/revisions/d32d3faa5345?raw)