Skip to main content
POST
/
api
/
user
/
phone-numbers
/
purchase
Purchase Phone Number
curl --request POST \
  --url https://app.famulor.de/api/user/phone-numbers/purchase \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "phone_number": "<string>"
}
'
{
  "message": "Phone number purchased successfully.",
  "data": {
    "id": 123,
    "phone_number": "+14155551234",
    "country_code": "US",
    "type": "normal",
    "sms_capable": true
  }
}
This endpoint allows you to purchase a phone number that was found via the Search endpoint. The platform automatically handles pricing, billing, and provisioning.
You must have a valid payment method on file before you can purchase a phone number. The purchase creates a monthly subscription that automatically renews.

​
Request Body

​
phone_number
string
required
The phone number to purchase in E.164 format (e.g. +14155551234). Must be a number returned by the Search endpoint.

​
Response Fields

​
message
string
Success message
​
data
object
The details of the purchased phone number

​
How It Works

  1. Search - First use the Search endpoint to find available numbers
  2. Purchase - Submit the desired phone number to this endpoint
  3. Automatic Processing - The platform:
    • Validates that the number is still available
    • Determines the correct price based on the country
    • Creates a monthly subscription on your payment method
    • Provisions the number with our telephony provider
    • Creates the phone number record in your account
Phone number purchases are non-refundable. The subscription will continue until you release the number.
{
  "message": "Phone number purchased successfully.",
  "data": {
    "id": 123,
    "phone_number": "+14155551234",
    "country_code": "US",
    "type": "normal",
    "sms_capable": true
  }
}