---
title: "Check a verification"
method: POST
path: "/verifications/{id}/checks"
tags: ["Verifications"]
---

# Check a verification

`POST /verifications/{id}/checks`

Checks the code against a verification.

## Path parameters

- `id` string, required — The ID of the verification to check against.

## Request body

- VerificationCheckParams — Parameters for checking a Verification code
  - `code` string, required — The Verification code that was received.

## Response `200`

Correct code

- VerificationCheck — The result of checking a Verification code
  - `result` 'ok' | 'incorrect' | 'exhausted' | 'expired' | 'already_verified' — The result of the code check.
  - `verification` Verification — A phone number verification
    - `attempt_count` integer, required — The number of times the code has been attempted.
    - `id` string, required — Unique identifier for the object.
    - `phone_number` string, phone-number, required — The phone number being verified. In E.164 format.
    - `status` 'pending' | 'verified' | 'exhausted' | 'expired', required — The current status of the verification.

## Other responses

- `409` — Already verified
- `422` — Check failed
- `default` — Error

---

[API](https://skmtc.net/surgeapi/apis/surge.md) · [All operations](https://skmtc.net/surgeapi/apis/surge/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/surgeapi/surge/revisions/b5b0b6f62245/schema)