---
title: "Create a verification"
method: POST
path: "/verifications"
tags: ["Verifications"]
---

# Create a verification

`POST /verifications`

Creates a new Verification and sends the code to the given phone number.

## Request body

- VerificationParams — Parameters for creating a Verification
  - `phone_number` string, phone-number, required — The phone number to be verified. In E.164 format.

## Response `201`

Created 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

- `default` — Error

---

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