---
title: "Verify a phone number"
method: POST
path: "/v2/verified-resources/phones/verification-code/verify"
tags: ["Verified Resources"]
---

# Verify a phone number

`POST /v2/verified-resources/phones/verification-code/verify`

Use code to verify a phone number

## Headers

- `Authorization` string, required

## Request body

- VerifyPhoneInput
  - `phone` string, required — phone number to verify.
  - `code` string, required — verification code sent to the phone number to verify

## Response `200`

- UserVerifiedPhoneOutput
  - `status` 'success' | 'error', required
  - `data` UserVerifiedPhoneOutputData, required
    - `id` number, required — The unique identifier for the verified email.
    - `phoneNumber` string, phone, required — The verified phone number.
    - `userId` number, required — The ID of the associated user, if applicable.

## Changes

- **2026-03-10** (v2) `ba131b4bbebb` — 9 breaking, 1 warning, 2 info
  - removed the required property `data/availability` from the response with the `200` status
  - removed the required property `data/isDefault` from the response with the `200` status
  - removed the required property `data/isLastSchedule` from the response with the `200` status
  - removed the required property `data/isManaged` from the response with the `200` status
  - …8 more
- **2025-09-26** (v2) `daa3e48bc03a` — 2 breaking, 10 info
  - removed the required property `data/phoneNumber` from the response with the `200` status
  - removed the required property `data/userId` from the response with the `200` status
  - added the optional property `data/dateOverrides` to the response with the `200` status
  - added the required property `data/availability` to the response with the `200` status
  - …8 more

[Change history](https://skmtc.dev/calcom/apis/cal-diy-api-v2/changes/v2/verified-resources/phones/verification-code/verify/post.md)

---

[API](https://skmtc.dev/calcom/apis/cal-diy-api-v2.md) · [All operations](https://skmtc.dev/calcom/apis/cal-diy-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/calcom/cal-diy-api-v2/revisions/16de9d3eb7b3/schema)