---
title: "Get Phone Number"
method: GET
path: "/v1/phone-numbers/{uid}"
tags: ["Phone Numbers"]
---

# Get Phone Number

`GET /v1/phone-numbers/{uid}`

Retrieve details of a specific phone number by its UID.

## Path parameters

- `uid` string, required

## Response `200`

Phone number details retrieved successfully

- PhoneNumberResponse
  - `phone_number_id` string, required — Unique identifier of the phone number
  - `phone_number` string, required — Phone number in E.164 format
  - `name` string — Friendly name for the phone number
  - `inbound_agent_id` string — Bot ID for inbound calls
  - `outbound_agent_id` string — Bot ID for outbound calls
  - `created_at` string, date-time, required — Phone number creation timestamp
  - `updated_at` string, date-time, required — Phone number last update timestamp

## Other responses

- `400` — Bad request - missing or invalid organization/account information
- `401` — Unauthorized - missing or invalid API key
- `404` — Phone number not found
- `500` — Internal server error

---

[API](https://skmtc.net/openmicai/apis/openmic-v1-external-api.md) · [All operations](https://skmtc.net/openmicai/apis/openmic-v1-external-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/openmicai/openmic-v1-external-api/revisions/71c32e6ffd95/schema)