---
title: "Retrieve an OTP code to verify a Phone Number"
method: POST
path: "/api/v1/verification"
tags: ["KYC"]
---

# Retrieve an OTP code to verify a Phone Number

`POST /api/v1/verification`

This call replaces the existing phone number for a user if it exists, whether it's verified or not.

## Request body

- object
  - `phoneNumber` string, required

## Response `200`

OTP was sent.

- object
  - `ok` boolean

## Other responses

- `401` — Unauthorized Error
- `404` — User not found.
- `422` — Failed validation and OTP was not sent.
- `429` — Maximum verification attempts reached. Please try again later.
- `500` — Failed to send verification.

---

[API](https://skmtc.net/gnosispay/apis/gnosispay-api.md) · [All operations](https://skmtc.net/gnosispay/apis/gnosispay-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gnosispay/gnosispay-api/versions/e0a09962c187/schema)