Purchase phone number

  The unique identifier of the phone number

  The phone number in E.164 format

  The ISO country code

  The phone number type (always `normal` for purchased numbers)

  Whether the number supports SMS

{
  "message": "Phone number purchased successfully.",
  "data": {
    "id": 123,
    "phone_number": "+14155551234",
    "country_code": "US",
    "type": "normal",
    "sms_capable": true
  }
}

{
  "error": "This phone number is already in use."
}

{
  "error": "This phone number is not available for purchase. Please search for available numbers first."
}

{
  "error": "No payment method found. Please add a payment method to your account."
}

{
  "error": "Payment failed. Please update your payment method."
}

{
  "error": "Unable to parse phone number. Please provide a valid E.164 format number."
}

{
  "error": "Failed to purchase phone number from provider. Please contact support."
}