---
title: "OTP Verify Request"
method: POST
path: "/streams/otp/verify"
tags: ["Streams Service"]
---

# OTP Verify Request

`POST /streams/otp/verify`

Verify the code a recipient submitted against the active OTP for their phone number. Returns `verification: true` on a match, otherwise `false`.

A wrong code is a normal `false` result with HTTP `200` — not an error. Errors (e.g. too many failed attempts) are returned via the standard error envelope.

**Authentication:** stream token in the `Authorization` header (see **Authentication** in the API Overview).

## Request body

- object
  - `recipient_phone` string, required — The phone number that received the OTP, in international format.
  - `code` string, required — The OTP code the recipient submitted.

## Response `200`

The verification result.

- object
  - `verification` boolean — `true` if the submitted code matches the active OTP; otherwise `false`.

---

[API](https://skmtc.net/commpeak/apis/dialer-api-v2-0-1.md) · [All operations](https://skmtc.net/commpeak/apis/dialer-api-v2-0-1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/commpeak/dialer-api-v2-0-1/versions/eacecf960bb6/schema)