---
title: "Check a verification"
method: POST
path: "/verify/verificationChecks"
tags: ["Verify"]
---

# Check a verification

`POST /verify/verificationChecks`

Checks a verification with a phone number, an email address, or a verification ID.
A `pending` verification status changes to `approved` once you receive a response with the `valid` parameter is `true`. An approved verification cannot be checked anymore.

## Request body

- VerificationCheckRequest
  - `verificationId` string — ID of the verification to be checked. One of `verificationId` or `to` is required.
  - `to` string — The recipient's phone number or email address. One of `verificationId` or `to` is required.
  - `code` string — The verification to be checked.

## Response `200`

Successfully processed the verification check.

- VerificationCheck
  - `id` string, required — ID of this verification check.
  - `valid` boolean, required — Whether the verification code is valid for this check.
  - `status` 'pending' | 'approved' | 'blocked' | 'expired' | 'undelivered' — Status of the verification. - `pending`: The verification message (SMS, Voice, etc.) is sent, waiting to be checked. This happens when you call the 'Start a verification' API successfully. - `approved`: The verification has been successfully checked. A `pending` verification status changes to `approved` when you call the 'Check a verification' API and receive a response with the `valid` parameter is `true`. An approved verification cannot be checked anymore. - `blocked`: The verification is blocked by user-defined rules such as denylist, and geographical permission restrictions. A blocked verification cannot be checked. - `expired`: The verification has expired and cannot be checked anymore. - `undelivered`: Our system has received a delivery receipt indicating that the verification message was not delivered. An undelivered verification cannot be checked anymore.
  - `to` string — The recipient's phone number in [E.164](https://en.wikipedia.org/wiki/E.164) format or email address.
  - `channel` 'sms' | 'voice' | 'email_code' | 'whatsapp' — Supports several independent channels for verification: - `sms`: Sends an SMS message with a verification code. - `voice`: Makes a voice call with a verification code. - `email_code`: Sends an email with a verification code. - `whatsapp`: Sends a WhatsApp message with a verification code.

---

[API](https://skmtc.dev/ycloud/apis/ycloud-api.md) · [All operations](https://skmtc.dev/ycloud/apis/ycloud-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ycloud/ycloud-api/revisions/4e13d3ca9df8/schema)