Buy Phone Numbers

Purchase one or more phone numbers found through the search endpoint.

Billing uses your account credits and the numbers are ready for immediate use.

Headers

PINNACLE-API-KEYstringRequired

Request

This endpoint expects an object.
numberslist of stringsRequired

List of phone numbers you want to purchase, each in international E.164 format.

All specified numbers must be currently available and will be validated for availability before processing the purchase.

If any number in the request is unavailable or invalid, no purchases will be made and the request will be voided.

Response

Successfully purchased the number(s).

numberstring
Purchased phone number in E.164 format.
capabilitiesobject
Enabled communication features for the phone number.

Errors