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>"
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({phone_number: '<string>'})
};

fetch('https://app.famulor.de/api/user/phone-numbers/purchase', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://app.famulor.de/api/user/phone-numbers/purchase"

payload = { "phone_number": "<string>" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.famulor.de/api/user/phone-numbers/purchase",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'phone_number' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.famulor.de/api/user/phone-numbers/purchase"

	payload := strings.NewReader("{\n  \"phone_number\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "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."
}

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>"
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({phone_number: '<string>'})
};

fetch('https://app.famulor.de/api/user/phone-numbers/purchase', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://app.famulor.de/api/user/phone-numbers/purchase"

payload = { "phone_number": "<string>" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.famulor.de/api/user/phone-numbers/purchase",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'phone_number' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.famulor.de/api/user/phone-numbers/purchase"

	payload := strings.NewReader("{\n  \"phone_number\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "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."
}

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

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

string

Success message

object

The details of the purchased phone number

Show Data Properties

integer

The unique identifier of the phone number

string

The phone number in E.164 format

string

The ISO country code

string

The phone number type (always normal for purchased numbers)

boolean

Whether the number supports SMS

How It Works

Search - First use the Search endpoint to find available numbers
Purchase - Submit the desired phone number to this endpoint
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
  }
}

{
  "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."
}

Search Available Phone Numbers Release Phone Number

API Reference

AI Assistants

Folders

Labels

Leads

Campaigns

Mid Call Actions

AI Chatbot

AI Replies

Knowledgebases

SMS

WhatsApp

Phone Numbers

SIP Trunks

Calls

Webhooks

Purchase Phone Number

Request Body

Response Fields

How It Works

​Request Body

​Response Fields

​How It Works

Request Body

Response Fields

How It Works