---
title: "Reveal OTP"
method: GET
path: "/v1/banking/bank_devices/{bank_device_id}/reveal"
tags: ["Bank device"]
---

# Reveal OTP

`GET /v1/banking/bank_devices/{bank_device_id}/reveal`

## Request

- Base URL: `https://api.cardda.com`
- URL: `https://api.cardda.com/v1/banking/bank_devices/{bank_device_id}/reveal`
- Auth: HTTP bearer

Returns the current bank device one time password (OTP)

## Parameters

- `#/paths/~1v1~1banking~1bank_keys/get/parameters/0` (unresolved $ref)
- `#/paths/~1v1~1banking~1bank_devices~1%7Bbank_device_id%7D/get/parameters/1` (unresolved $ref)

## Response `200`

formatted bank device otp

- object
  - `code` string

## Other responses

- `401`: Unauthorized
- `404`: The bank device is not registered on Cardda
- `425`: The device revealed the same token as the previous one
- `429`: The device is executing another request at the current moment
- `502`: The OCR providers did not agree on the token read from the device
- `504`: The device took too long to read the current token

---

[API](https://skmtc.dev/cardda/apis/banking-api.md) - [All operations](https://skmtc.dev/cardda/apis/banking-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cardda/apis/banking-api/revisions/ff1aeb3fda8b?raw)