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

# Get a phone number

`GET /v1/logins/{id}/sms-number`

## Request

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

Returns the Pomerado phone number that receives a saved login's text-message sign-in codes.

- During a verification, verification shows whether a code arrived and the newest code.
- A login without a number returns sms_number_not_linked.

## Path parameters

- `id` string, required

## Response `200`

The login's number

- 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
- `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)