---
title: "Verify a PIN"
method: POST
path: "/v2/profiles/{profileId}/pin/verify"
tags: ["sca-pin"]
---

# Verify a PIN

`POST /v2/profiles/{profileId}/pin/verify`

Verifies a PIN challenge when calling a SCA-secured endpoint. Make sure to [create a PIN](/api-reference/sca-pin/scapincreate) before using this endpoint.

The request and response are encrypted using the JOSE framework. Please refer to the [SCA over API guide](/guides/developer/auth-and-security/sca-over-api) to understand how encryption and decryption work.

## Path parameters

- `profileId` integer, required

## Headers

- `One-Time-Token` string, uuid, required
- `Accept` string, required
- `Accept-Encoding` string, required
- `Content-Encoding` string, required
- `X-tw-jose-method` string, required
- `X-External-Correlation-Id` string, uuid

## Response `200`

The PIN has been successfully verified.

- OneTimeToken — A one-time token is generated when accessing an endpoint secured by SCA. This token includes a list of all available challenges to complete. You can use the [OTT status endpoint](/api-reference/sca-ott/ottstatusget) to view challenges and their statuses, or use [create SCA session](/api-reference/sca-sessions/scasessioncreate) to manually trigger SCA and return a one-time token.
  - `oneTimeToken` string, uuid — A one-time token unique identifier.
  - `challenges` object[] — An array of challenges.
    - `primaryChallenge` object
      - `type` string — A type of challenge.
    - `passed` boolean — The status of a challenge.
  - `validity` integer — The One-Time Token expiration in seconds.

## Other responses

- `400` — The PIN verification failed or PIN was blocked.
- `404` — The PIN was not found or has not been set up.
- `429` — Rate limit exceeded. Retry after the number of seconds specified in the `Retry-After` header.

---

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