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

# Overview

> Learn about phone number types, availability, rental, and compliance on Plivo.

<Info title="TL;DR">
  * **What:** Rent local, toll-free, and mobile phone numbers from Plivo in 100+ countries for voice and messaging
  * **How:** Search and buy via [Console](https://cx.plivo.com/phone-numbers) or [Phone Numbers API](/numbers/phone-numbers). Numbers are billed as recurring monthly rentals
  * **Compliance:** Many countries require identity documents before numbers can be rented. India in particular has its own KYC process — see the country sections below
</Info>

Phone numbers are carrier-recognized identifiers that enable applications to send and receive calls and messages over the public telephone network (PSTN). They provide reachability to global mobile and landline networks, trust through verified caller identity, and support for voice, SMS, and MMS capabilities.

You can learn more about searching and buying numbers in the [Phone Numbers API documentation](/numbers/phone-numbers), and learn more about accessing the numbers already added to your account in the [Account Phone Numbers API documentation](/numbers/account-phone-numbers).

## Phone number types

Plivo offers different phone number types depending on the country. Availability varies by region—see the [Country availability](#country-availability) table below.

### Fixed (Local) numbers

Fixed numbers are assigned to a specific region—a city, area, or country. Callers from within the region are charged local rates. Fixed numbers support voice, and in some countries (like the US and Canada) also support SMS.

### Toll-free numbers

Toll-free numbers (prefixes like 1800 or 800) are free for callers—charges are billed to the number owner. Businesses use them for customer service lines and SMS messaging.

### Mobile numbers

Mobile numbers support SMS and voice. Plivo offers mobile numbers in select countries only (UK, Australia).

## Country availability

Plivo offers phone numbers in the following countries, grouped by the plan required to rent them.

### Pay As You Go

Available on any account — no monthly commit.

| Country       | Documents needed     |
| ------------- | -------------------- |
| United States | None                 |
| India         | Yes — India-specific |

### Enterprise

Requires a \$1,000/month minimum commit.

| Country              | Documents needed |
| -------------------- | ---------------- |
| Canada               | None             |
| United Kingdom       | None             |
| Australia            | None             |
| New Zealand          | Yes              |
| Singapore            | Yes              |
| Brazil               | Yes              |
| United Arab Emirates | Yes              |
| Saudi Arabia         | Yes              |
| Malaysia             | Yes              |
| Indonesia            | Yes              |

For per-number rental and plan pricing, see [Plivo Pricing](https://www.plivo.com/pricing/).

### Compliance documents by country

Most countries require regulatory documents before numbers can be activated. Countries not listed below (US, Canada, UK, Australia) do not require compliance documents. See [Regulatory Compliance](/numbers/compliance) for the submission process.

<AccordionGroup>
  <Accordion title="India">
    India has multiple number series with different compliance requirements:

    * **Fixed (080, 022)** — See [India Calling Guidelines](/voice/concepts/india-calling) for KYC and DoT requirements.
    * **160-series** — Allocated exclusively to BFSI entities for transactional and service calls. See [160-series Provisioning](/voice/concepts/160-series-provisioning) for the full DLT/DoT process.
  </Accordion>

  <Accordion title="New Zealand">
    * National address (in New Zealand)
    * Tax ID (NZBN)
  </Accordion>

  <Accordion title="Singapore">
    * National address (in Singapore)
    * Tax ID (NRIC)
  </Accordion>

  <Accordion title="United Arab Emirates">
    * International business registration
    * Foreign address
    * Letter of Intent (LOI)
  </Accordion>

  <Accordion title="Saudi Arabia">
    * International business registration
    * Letter of Intent (LOI)
  </Accordion>

  <Accordion title="Brazil">
    Requirements depend on the number type:

    * **Local numbers** — Local address, Tax ID (CNPJ)
    * **Toll-free numbers** — National address (in Brazil), Tax ID (CNPJ)
  </Accordion>

  <Accordion title="Malaysia">
    * National address (in Malaysia)
    * Tax ID (national)
  </Accordion>

  <Accordion title="Indonesia">
    * Full name and contact phone of authorized representative
    * Company name
    * Company business registration (local)
    * Use case description
  </Accordion>
</AccordionGroup>

## Renting phone numbers

### Via Console

1. Navigate to **Phone Numbers > Buy Numbers**
2. Filter by country, capabilities (Voice, SMS, MMS), and number type
3. Click **Buy Number**

### Via API

Use the [Phone Number API](/numbers/phone-numbers#buy-a-phone-number) to rent numbers programmatically.

There is no limit on the number of phone numbers you can rent, as long as you have sufficient credits.

## Charges

| Charge             | Description                                                |
| ------------------ | ---------------------------------------------------------- |
| **Monthly Rental** | Recurring fee, billed from rental date                     |
| **Setup Fee**      | One-time fee when renting (applicable in select countries) |

See [Phone Number Pricing](https://www.plivo.com/virtual-phone-numbers/pricing/) for details.

## Compliance requirements

Many countries require regulatory documentation before numbers can be activated. Requirements vary by country, number type, and end-user type (business or individual).

Compliance applications bundle end-user information and regulatory documents for country-specific compliance requirements. Assign them during number rental or via **Phone Numbers > Compliance Applications** in the Console.

See [Regulatory Compliance](/numbers/compliance) for details.

## Caller ID and CNAM

### Branded Caller ID (CNAM)

CNAM (Caller Name) displays your business name instead of just the phone number on outgoing calls.

| Country           | CNAM Support                                                                                                                                                             |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **United States** | Supported. See [CNAM Lookup](/numbers/cnam-lookup) for details.                                                                                                          |
| **India**         | Not yet available. Indian carriers are gradually rolling out CNAM support. Plivo is working with carriers and will notify customers when this feature becomes available. |

### Verified Caller ID

Verified Caller ID lets you use your own non-Plivo number as a caller ID for outbound calls:

1. Go to [Verified Caller IDs](https://cx.plivo.com/home)
2. Add your phone number
3. Complete verification via SMS or voice call
4. Use the verified number as the `from` parameter in API calls

<Warning>
  **India:** Verified Caller ID is not supported. All outbound calls from India must use a Plivo-rented Indian number as the caller ID.
</Warning>

## Bulk Operations

### Bulk Number Purchase

Use the API to search and rent multiple numbers:

```python theme={null}
# Search for available numbers
numbers = client.numbers.search(country_iso='US', type='local', limit=10)

# Rent each number
for number in numbers:
    client.numbers.buy(number.number)
```

### Bulk Unrent

```python theme={null}
# List your numbers
my_numbers = client.numbers.list()

# Unrent specific numbers
for number in numbers_to_unrent:
    client.numbers.delete(number)
```

<Note>
  API rate limits apply. For bulk operations exceeding 100 numbers, spread requests over time or contact support for higher limits.
</Note>

### Get Available Countries

List countries where numbers are available:

```bash theme={null}
curl -i --user AUTH_ID:AUTH_TOKEN \
  https://api.plivo.com/v1/Account/{auth_id}/PhoneNumber/
```

## Related concepts

### Subaccounts

Subaccounts let you link numbers to isolate traffic across departments, customers, or use cases. Each subaccount has its own Auth ID and Token; charges deduct from the main account.

See [Subaccount API](/account/api/subaccount) for details.

### Plivo Applications

A Plivo Application is assigned to numbers to define how incoming calls and messages are handled using XML instructions.

See [Application API](/account/api/application) and [Voice XML](/voice/xml/overview) for details.
