> ## Documentation Index
> Fetch the complete documentation index at: https://dialnexa.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Phone Numbers overview

> Search, buy, connect, inspect, assign, and retire v1 phone numbers.

Phone numbers provide inbound and outbound telephony routes for agents. Purchasing and deleting numbers can affect billing and live routing.

## Choose a provisioning path

| Path | Use when | Operations |
| - | - | - |
| Provider inventory | You want DialNexa to provision a Plivo number. | Review [pricing](https://dialnexa.com/docs/api-reference/v1/phone-numbers/list-pricing.md), [search](https://dialnexa.com/docs/api-reference/v1/phone-numbers/search-plivo.md), then [buy](https://dialnexa.com/docs/api-reference/v1/phone-numbers/buy.md). |
| Bring your own carrier | You already control the number and SIP trunk. | [Link SIP Trunk](https://dialnexa.com/docs/api-reference/v1/phone-numbers/link-sip-trunk.md). |

Before outbound calling, compare the [global country catalog](https://dialnexa.com/docs/api-reference/v1/phone-numbers/list-country-rules.md) with the [network groups enabled for your workspace](https://dialnexa.com/docs/api-reference/v1/phone-numbers/list-enabled-network-groups.md).

## Lifecycle

* [List](https://dialnexa.com/docs/api-reference/v1/phone-numbers/list.md) and [get](https://dialnexa.com/docs/api-reference/v1/phone-numbers/get.md) phone numbers before changing routing.
* Link a number to an agent for inbound or outbound calls with [Attach Agent Phone Number](https://dialnexa.com/docs/api-reference/v1/agents/attach-phone-number.md); the link belongs to the agent, so every version uses it, and inbound calls run on the latest published version.
* Confirm no active agent or workflow depends on the route before [deleting](https://dialnexa.com/docs/api-reference/v1/phone-numbers/delete.md).

> [!WARNING]
>
> Buying a provider number can create a billable rental. A timeout is ambiguous; list workspace numbers before submitting the purchase again.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.