---
title: "Check a code"
method: POST
path: "/check"
tags: ["OTP"]
deprecated: true
---

# Check a code

`POST /check`

> **Deprecated.**

Check that a code entered by a user is valid.

## Request body

- CreateCheckRequest
  - `customer_uuid` string, uuid, required — Your customer UUID, which can be found in the API settings in the Dashboard.
  - `authentication_uuid` string, uuid, required — The authentication UUID that was returned when you created the authentication.
  - `check_code` string, required — The code that the user entered.

## Response `200`

OK

- CreateCheckResponse
  - `authentication_uuid` string, uuid — The UUID of the corresponding authentication.
  - `status` 'unknown' | 'valid' | 'invalid' | 'without_attempt' | 'rate_limited' | 'already_validated' | 'expired_auth' — The status of the check. Possible values are: * `unknown` - The status is unknown. * `valid` - The code is valid. * `invalid` - The code is invalid. * `without_attempt` - No attempt was sent yet, so a check cannot be completed. * `rate_limited` - The authentication was rate limited and cannot be checked. * `already_validated` - The authentication has already been validated. * `expired_auth` - The authentication has expired and cannot be checked.

## Other responses

- `400` — Bad Request

## Changes

- **2025-04-28** `187cbbb71a45` — 1 info
  - endpoint deprecated
- **2024-10-30** `1ec3fb120b7d` — 1 info
  - added the non-success response with the status `400`
- **2024-10-28** `ad06e2f6b7f4` — 1 info
  - removed the non-success response with the status `400`
- **2024-10-28** `7331a813b16b` — 1 breaking, 2 warning, 7 info
  - the `status` response's property type/format changed from `string`/`` to ``/`` for status `200`
  - added the new `invalid_sender_id` enum value to the `code` response property for the response status `400`
  - added the new `unauthorized_sender_id` enum value to the `code` response property for the response status `400`
  - added `#/components/schemas/CheckStatus` to the `status` response property `allOf` list for the response status `200`
  - …6 more
- **2024-04-23** `8864239c4906` — 1 warning
  - added the new `suspended_account` enum value to the `code` response property for the response status `400`

[Full history](https://skmtc.dev/ding-live/apis/ding/changes/check/post.md)

---

[API](https://skmtc.dev/ding-live/apis/ding.md) · [All operations](https://skmtc.dev/ding-live/apis/ding/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ding-live/ding/revisions/060cbae07b8f/schema)