---
title: "Verify a phone number"
method: POST
path: "/v1/logins/{id}/sms-number/verify"
tags: ["two_factor"]
---

# Verify a phone number

`POST /v1/logins/{id}/sms-number/verify`

## Request

- Base URL: `https://api.pomerado.ai`
- URL: `https://api.pomerado.ai/v1/logins/{id}/sms-number/verify`
- Auth: HTTP bearer

Starts a 10-minute verification of a login's Pomerado phone number. During it, send the number a test text or have the website send a code, then call logins.get_sms_number to read the code that arrived.

## Path parameters

- `id` string, required

## Response `200`

The login's number, verifying

- SmsNumber
  - `phone_number` string, required
  - `status` 'linked' | 'verified', required
  - `linked_at` string, required
  - `verified_at` string, nullable, required
  - `verification` object, nullable, required
    - `expires_at` string, required
    - `code_received` boolean, required
    - `code` string, nullable, required

## Other responses

- `400`: invalid_request
- `401`: unauthorized, reauthentication_required
- `403`: sms_number_not_allowed, forbidden
- `404`: not_found, sms_number_not_linked
- `500`: internal_error
- `501`: not_configured
- `503`: temporarily_unavailable

---

[API](https://skmtc.dev/pomerado/apis/pomerado-api.md) · [All operations](https://skmtc.dev/pomerado/apis/pomerado-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pomerado/apis/pomerado-api/revisions/48dac2a3143e?raw)