Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.intellixent.ai/llms.txt

Use this file to discover all available pages before exploring further.

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
string
required
Phone number to purchase in E.164 format (e.g., +14155551234). Must be a number returned from the search endpoint.

​
Response

​
message
string
Confirmation message.
​
data
object
The purchased phone number details.

​
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"}'
201 Created
{
  "message": "Phone number purchased successfully.",
  "data": {
    "id": 123,
    "phone_number": "+14155551234",
    "country_code": "US",
    "type": "normal",
    "sms_capable": true
  }
}
402 No payment method
{
  "error": "No payment method found. Please add a payment method to your account."
}
400 Already in use
{
  "error": "This phone number is already in use."
}
Purchases are non-refundable. The subscription continues until you release the number.