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

# Get Phone Number

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

Retrieves the full configuration of a single phone number by its +E.164 value. Returns assigned agents, active status, provider, and SIP configuration for BYO numbers.

## Path parameters

- `phoneNumber` string, required

## Response `200`

OK

- PhoneNumberResponse — Caller phone number used to dial contacts in this campaign. This number appears as the caller ID on recipients' devices.
  - `sipPhoneNumber` string — The caller’s phone number in +E.164 format. This number must be obtained from SigmaMind or configured using SIP trunking with SigmaMind.
  - `provider` 'twilio' | 'telnyx' | 'byo' — The service provider associated with the phone number.
  - `inboundAgentId` string — Default agent ID assigned to handle inbound calls for this phone number.
  - `outboundAgentId` string — Default agent ID assigned to handle outbound calls for this phone number.
  - `outboundPhoneNumber` string — The default outbound phone number of the callee, represented in +E.164 format
  - `active` boolean — Indicates whether the phone number is currently active and available for use.
  - `terminationSipURI` string — The SIP URI of the phone number, provided by the service provider for call termination.
  - `friendlyName` string — A user-friendly display name assigned to this phone number.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/sigmamind/apis/sigmamind-apis.md) · [All operations](https://skmtc.net/sigmamind/apis/sigmamind-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sigmamind/sigmamind-apis/revisions/d00f52b5123f/schema)