List Phone Numbers
curl --request GET \
--url https://app.famulor.de/api/user/phone-numbers/allimport requests
url = "https://app.famulor.de/api/user/phone-numbers/all"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://app.famulor.de/api/user/phone-numbers/all', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.famulor.de/api/user/phone-numbers/all",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://app.famulor.de/api/user/phone-numbers/all"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://app.famulor.de/api/user/phone-numbers/all")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.famulor.de/api/user/phone-numbers/all")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"data": [
{
"id": 1,
"phone_number": "+49155551234",
"nickname": "Sales line",
"country_code": "DE",
"type": "normal",
"type_label": "Dedicated Number",
"sms_capable": true,
"region": "us1",
"has_active_subscription": true,
"created_at": "2025-01-07T10:30:00.000000Z"
},
{
"id": 2,
"phone_number": "+442071234567",
"nickname": null,
"country_code": "GB",
"type": "normal",
"type_label": "Dedicated Number",
"sms_capable": false,
"region": "us1",
"has_active_subscription": true,
"created_at": "2025-01-05T14:20:00.000000Z"
}
]
}
Phone Numbers
List Phone Numbers
Retrieves all phone numbers of the authenticated user
GET
/
api
/
user
/
phone-numbers
/
all
List Phone Numbers
curl --request GET \
--url https://app.famulor.de/api/user/phone-numbers/allimport requests
url = "https://app.famulor.de/api/user/phone-numbers/all"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://app.famulor.de/api/user/phone-numbers/all', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.famulor.de/api/user/phone-numbers/all",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://app.famulor.de/api/user/phone-numbers/all"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://app.famulor.de/api/user/phone-numbers/all")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.famulor.de/api/user/phone-numbers/all")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"data": [
{
"id": 1,
"phone_number": "+49155551234",
"nickname": "Sales line",
"country_code": "DE",
"type": "normal",
"type_label": "Dedicated Number",
"sms_capable": true,
"region": "us1",
"has_active_subscription": true,
"created_at": "2025-01-07T10:30:00.000000Z"
},
{
"id": 2,
"phone_number": "+442071234567",
"nickname": null,
"country_code": "GB",
"type": "normal",
"type_label": "Dedicated Number",
"sms_capable": false,
"region": "us1",
"has_active_subscription": true,
"created_at": "2025-01-05T14:20:00.000000Z"
}
]
}
Famulor 1.0 API (legacy). This page applies only to Famulor 1.0 (
app.famulor.de) and is retained for legacy compatibility. For the current platform, use the Famulor 2.0 API reference.There is also a legacy endpoint
GET /user/phone-numbers that only returns SMS-capable phone numbers with active subscriptions. Use this /all endpoint when you need all phone numbers regardless of SMS capability or subscription status.Response Fields
array
Array of phone number objects
Show Phone Number Properties
Show Phone Number Properties
integer
The unique identifier of the phone number
string
The phone number in E.164 format (e.g. +49155551234)
string
A short, human-friendly label for the number (or
null if not set)string
The ISO 3166-1 alpha-2 country code (e.g. DE, GB, AU)
string
The type of phone number:
normal, sip or caller_idstring
Human-readable label for the phone number type
boolean
Whether the phone number can send and receive SMS
string
The region where the phone number was provisioned
boolean
Whether the phone number has an active subscription
string
ISO 8601 timestamp of when the phone number was purchased
{
"data": [
{
"id": 1,
"phone_number": "+49155551234",
"nickname": "Sales line",
"country_code": "DE",
"type": "normal",
"type_label": "Dedicated Number",
"sms_capable": true,
"region": "us1",
"has_active_subscription": true,
"created_at": "2025-01-07T10:30:00.000000Z"
},
{
"id": 2,
"phone_number": "+442071234567",
"nickname": null,
"country_code": "GB",
"type": "normal",
"type_label": "Dedicated Number",
"sms_capable": false,
"region": "us1",
"has_active_subscription": true,
"created_at": "2025-01-05T14:20:00.000000Z"
}
]
}
Related pages: Introduction and Authentication Guide, and API Integration Examples.
⌘I