> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.pinnacle.sh/v-2/guides/purchase-phone-numbers/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.pinnacle.sh/_mcp/server.

# Purchase Phone Numbers

> Search for and purchase phone numbers for your messaging campaigns.

Phone numbers are required for sending SMS and MMS messages through 10DLC and toll-free campaigns.

## Search available numbers

Find numbers that match your requirements with [`POST /phone-numbers/search`](/api-reference/phone-numbers/search).

### Filters

* **Location**: Find numbers in specific regions
* **Digits**: Match specific digits in the number
* **Features**: Filter by features such as SMS, MMS, voice, etc.
* **Number type**: Choose between local and toll-free

## Purchase numbers

Once you've found suitable numbers, buy them through [`POST /phone-numbers/buy`](/api-reference/phone-numbers/buy).

* **Processing time**: Immediate
* **Status check**: [`GET /status/phone-number/{phoneNumber}`](/api-reference/status/phone-number)

## Best practices

* Purchase multiple numbers for high-volume campaigns to distribute load
* Keep spare numbers ready for quick scaling
* Monitor number health and reputation regularly
* Rotate numbers periodically for long-running campaigns

## Next steps

After purchasing numbers, you need to attach them to your campaign before you can send messages.

#### 10DLC

Local 10-digit numbers for A2P messaging.

See [10DLC campaigns](/guides/campaigns/10dlc#attach-number-to-campaign) to send your first message.

#### Toll-Free

Numbers starting with 800, 833, 844, 855, 866, 877, or 888.

See [toll-free campaigns](/guides/campaigns/toll-free#attach-number-to-campaign) to send your first message.

#### RCS

Rich Communication Services for enhanced messaging. Phone numbers are not required for RCS campaigns but can be used for SMS fallback.

See [RCS campaigns](/guides/campaigns/rcs) for setup instructions.

> One API for RCS, iMessage, MMS, and SMS. Build, test, and scale every channel — send your first message in minutes, not weeks.