---
title: "POST /api/auth/phone-number/verify"
method: POST
path: "/api/auth/phone-number/verify"
tags: ["Phone-number"]
---

# POST /api/auth/phone-number/verify

`POST /api/auth/phone-number/verify`

Use this endpoint to verify phone number

## Request body

- object
  - `phoneNumber` string, required — Phone number to verify. Eg: "+1234567890"
  - `code` string, required — OTP code sent to the phone number
  - `disableSession` boolean — Optional flag to skip session creation after verification

## Response `200`

Phone number verified successfully

- object
  - `status` true, required — Indicates if the verification was successful
  - `token` string, nullable — Session token if session is created, null if disableSession is true or no session is created
  - `user` object, nullable — User object with phone number details, null if no user is created or found
    - `id` string, required — Unique identifier of the user
    - `email` string, email, nullable — User's email address
    - `emailVerified` boolean, nullable — Whether the email is verified
    - `name` string, nullable — User's name
    - `image` string, uri, nullable — User's profile image URL
    - `phoneNumber` string, required — User's phone number
    - `phoneNumberVerified` boolean, required — Whether the phone number is verified
    - `createdAt` string, date-time, required — Timestamp when the user was created
    - `updatedAt` string, date-time, required — Timestamp when the user was last updated

## Other responses

- `400` — Invalid OTP
- `401` — Unauthorized. Due to missing or invalid authentication.
- `403` — Forbidden. You do not have permission to access this resource or to perform this action.
- `404` — Not Found. The requested resource was not found.
- `429` — Too Many Requests. You have exceeded the rate limit. Try again later.
- `500` — Internal Server Error. This is a problem with the server that you cannot fix.

---

[API](https://skmtc.dev/fromolive/apis/olive-api.md) · [All operations](https://skmtc.dev/fromolive/apis/olive-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/fromolive/olive-api/revisions/01f6261481a3/schema)