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

# Get Phone Number

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

## Request

- Base URL: `https://api.sigmamind.ai`
- URL: `https://api.sigmamind.ai/v1/phone-numbers/{phoneNumber}`
- Auth: API key in header `X-API-Key`

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.dev/sigmamind/apis/sigmamind-apis.md) - [All operations](https://skmtc.dev/sigmamind/apis/sigmamind-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/sigmamind/apis/sigmamind-apis/revisions/783c9e4c5126?raw)