Purchases a phone number that was returned by the search endpoint. The platform handles pricing, billing, and provisioning automatically.
You must have a valid payment method on file before purchasing. The purchase creates a monthly subscription that auto-renews.
Endpoint
POST /user/phone-numbers/purchase
Request
Phone number to purchase in E.164 format (e.g., +14155551234). Must be a number returned from the search endpoint.
Response
The purchased phone number details.
Unique identifier of the phone number.
Phone number in E.164 format.
Phone number type — always normal for purchased numbers.
Whether the number supports SMS.
Example
curl -X POST "https://portal.intellixent.ai/api/user/phone-numbers/purchase" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"phone_number": "+14155551234"}'
{
"message": "Phone number purchased successfully.",
"data": {
"id": 123,
"phone_number": "+14155551234",
"country_code": "US",
"type": "normal",
"sms_capable": true
}
}
{
"error": "No payment method found. Please add a payment method to your account."
}
{
"error": "This phone number is already in use."
}