List Assistants
curl --request GET \
--url https://app.famulor.de/api/user/assistants/getimport requests
url = "https://app.famulor.de/api/user/assistants/get"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://app.famulor.de/api/user/assistants/get', 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/assistants/get",
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/assistants/get"
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/assistants/get")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.famulor.de/api/user/assistants/get")
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": 123,
"user_id": 456,
"phone_number_id": 789,
"engine_id": 1,
"synthesizer_id": 2,
"transcriber_id": 3,
"voice_id": 4,
"instance_id": 5,
"name": "Sales Assistant",
"variables": {
"company_name": "Famulor",
"product_focus": "AI Telephony"
},
"post_call_evaluation": true,
"fillers": 1,
"post_call_schema": [
{
"name": "customer_interested",
"type": "boolean",
"description": "Is the customer interested?"
}
],
"tools": [
{
"type": "end_call",
"data": {
"description": "End call when done"
}
},
{
"type": "assistant_transfer",
"data": {
"description": "Transfer to the Support Assistant when the customer needs technical help.",
"assistant_id": 13766,
"message_before_transfer": "Sure — let me transfer you to our support specialist.",
"speak_transfer_greeting": true
}
},
{
"type": "warm_call_transfer",
"data": {
"supervisor_phone": "+14155552001",
"outbound_phone_id": "7",
"description": "Transfer the call to a human supervisor when the customer requests to speak with a real person.",
"custom_sip": false,
"caller_id_mode": "outbound_number",
"hold_music": "hold_music",
"hold_music_volume": 80,
"hold_message": "Please hold while I connect you with a supervisor.",
"summary_instructions": "Introduce the conversation from your perspective:\n- WHO is calling (name, company if mentioned)\n- WHY they called (their goal or problem)\n- WHY a human is needed at this point\n\nKeep it brief (2-3 sentences).",
"briefing_initial_message": "Hello! I have a caller on the line who needs your assistance. May I brief you on the situation?",
"connected_message": "You are now connected with a supervisor. I'll leave you to it."
}
}
],
"is_webhook_active": true,
"webhook_url": "https://example.com/webhook",
"inbound_webhook_url": "https://example.com/inbound-webhook",
"language": "de",
"type": "outbound",
"status": "active",
"max_duration": 1800,
"record": true,
"initial_message": "Good day! I'm calling from Famulor...",
"system_prompt": "You are a friendly sales assistant...",
"flows_platform_id": null,
"timezone": "Europe/Berlin",
"created_at": "2024-01-15T10:30:00Z",
"updated_at": "2024-01-15T10:30:00Z",
"max_silence_duration": 3,
"reengagement_interval": 5,
"deleted_at": null,
"end_call_on_voicemail": 1,
"llm_temperature": "0.7",
"voice_stability": "0.8",
"voice_similarity": "0.9",
"allow_interruptions": true,
"enable_noise_cancellation": true,
"endpoint_sensitivity": 0.5,
"speech_speed": "1.0",
"endpoint_type": "vad",
"wait_for_customer": false,
"mode": "pipeline",
"language_id": 1,
"transcriber_provider_id": 1,
"synthesizer_provider_id": 1,
"llm_model_id": 1,
"multimodal_model_id": null,
"ambient_sound": "office",
"uuid": "550e8400-e29b-41d4-a716-446655440000",
"send_webhook_only_on_completed": true,
"include_recording_in_webhook": false,
"interrupt_sensitivity": 0.3,
"filler_config": {
"enabled": true,
"phrases": ["Hmm...", "I understand..."]
},
"knowledgebase_id": 100,
"knowledgebase_mode": "semantic",
"min_interrupt_words": 2,
"ambient_sound_volume": "0.3",
"widget_settings": {
"enabled": false
}
}
],
"current_page": 1,
"per_page": 10,
"total": 1,
"last_page": 1
}
AI Assistants
List Assistants
List all assistants for the authenticated user with pagination
GET
/
api
/
user
/
assistants
/
get
List Assistants
curl --request GET \
--url https://app.famulor.de/api/user/assistants/getimport requests
url = "https://app.famulor.de/api/user/assistants/get"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://app.famulor.de/api/user/assistants/get', 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/assistants/get",
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/assistants/get"
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/assistants/get")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.famulor.de/api/user/assistants/get")
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": 123,
"user_id": 456,
"phone_number_id": 789,
"engine_id": 1,
"synthesizer_id": 2,
"transcriber_id": 3,
"voice_id": 4,
"instance_id": 5,
"name": "Sales Assistant",
"variables": {
"company_name": "Famulor",
"product_focus": "AI Telephony"
},
"post_call_evaluation": true,
"fillers": 1,
"post_call_schema": [
{
"name": "customer_interested",
"type": "boolean",
"description": "Is the customer interested?"
}
],
"tools": [
{
"type": "end_call",
"data": {
"description": "End call when done"
}
},
{
"type": "assistant_transfer",
"data": {
"description": "Transfer to the Support Assistant when the customer needs technical help.",
"assistant_id": 13766,
"message_before_transfer": "Sure — let me transfer you to our support specialist.",
"speak_transfer_greeting": true
}
},
{
"type": "warm_call_transfer",
"data": {
"supervisor_phone": "+14155552001",
"outbound_phone_id": "7",
"description": "Transfer the call to a human supervisor when the customer requests to speak with a real person.",
"custom_sip": false,
"caller_id_mode": "outbound_number",
"hold_music": "hold_music",
"hold_music_volume": 80,
"hold_message": "Please hold while I connect you with a supervisor.",
"summary_instructions": "Introduce the conversation from your perspective:\n- WHO is calling (name, company if mentioned)\n- WHY they called (their goal or problem)\n- WHY a human is needed at this point\n\nKeep it brief (2-3 sentences).",
"briefing_initial_message": "Hello! I have a caller on the line who needs your assistance. May I brief you on the situation?",
"connected_message": "You are now connected with a supervisor. I'll leave you to it."
}
}
],
"is_webhook_active": true,
"webhook_url": "https://example.com/webhook",
"inbound_webhook_url": "https://example.com/inbound-webhook",
"language": "de",
"type": "outbound",
"status": "active",
"max_duration": 1800,
"record": true,
"initial_message": "Good day! I'm calling from Famulor...",
"system_prompt": "You are a friendly sales assistant...",
"flows_platform_id": null,
"timezone": "Europe/Berlin",
"created_at": "2024-01-15T10:30:00Z",
"updated_at": "2024-01-15T10:30:00Z",
"max_silence_duration": 3,
"reengagement_interval": 5,
"deleted_at": null,
"end_call_on_voicemail": 1,
"llm_temperature": "0.7",
"voice_stability": "0.8",
"voice_similarity": "0.9",
"allow_interruptions": true,
"enable_noise_cancellation": true,
"endpoint_sensitivity": 0.5,
"speech_speed": "1.0",
"endpoint_type": "vad",
"wait_for_customer": false,
"mode": "pipeline",
"language_id": 1,
"transcriber_provider_id": 1,
"synthesizer_provider_id": 1,
"llm_model_id": 1,
"multimodal_model_id": null,
"ambient_sound": "office",
"uuid": "550e8400-e29b-41d4-a716-446655440000",
"send_webhook_only_on_completed": true,
"include_recording_in_webhook": false,
"interrupt_sensitivity": 0.3,
"filler_config": {
"enabled": true,
"phrases": ["Hmm...", "I understand..."]
},
"knowledgebase_id": 100,
"knowledgebase_mode": "semantic",
"min_interrupt_words": 2,
"ambient_sound_volume": "0.3",
"widget_settings": {
"enabled": false
}
}
],
"current_page": 1,
"per_page": 10,
"total": 1,
"last_page": 1
}
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.Query Parameters
Response Fields
Array of assistants
Show Assistant Properties
Show Assistant Properties
Array of built-in tools configured on the assistant. Each item has
type (tool identifier) and data (tool-specific settings). This response shape differs from the flat object used in Create and Update requests.Show Response item shape
Show Response item shape
type— e.g.end_call,call_transfer,warm_call_transfer,dtmf_input,collect_keypad,calendar_integration,assistant_transferdata— object with the tool’s configuration fields (same names as in the request body, nested underdatainstead of top-level)
{
"data": [
{
"id": 123,
"user_id": 456,
"phone_number_id": 789,
"engine_id": 1,
"synthesizer_id": 2,
"transcriber_id": 3,
"voice_id": 4,
"instance_id": 5,
"name": "Sales Assistant",
"variables": {
"company_name": "Famulor",
"product_focus": "AI Telephony"
},
"post_call_evaluation": true,
"fillers": 1,
"post_call_schema": [
{
"name": "customer_interested",
"type": "boolean",
"description": "Is the customer interested?"
}
],
"tools": [
{
"type": "end_call",
"data": {
"description": "End call when done"
}
},
{
"type": "assistant_transfer",
"data": {
"description": "Transfer to the Support Assistant when the customer needs technical help.",
"assistant_id": 13766,
"message_before_transfer": "Sure — let me transfer you to our support specialist.",
"speak_transfer_greeting": true
}
},
{
"type": "warm_call_transfer",
"data": {
"supervisor_phone": "+14155552001",
"outbound_phone_id": "7",
"description": "Transfer the call to a human supervisor when the customer requests to speak with a real person.",
"custom_sip": false,
"caller_id_mode": "outbound_number",
"hold_music": "hold_music",
"hold_music_volume": 80,
"hold_message": "Please hold while I connect you with a supervisor.",
"summary_instructions": "Introduce the conversation from your perspective:\n- WHO is calling (name, company if mentioned)\n- WHY they called (their goal or problem)\n- WHY a human is needed at this point\n\nKeep it brief (2-3 sentences).",
"briefing_initial_message": "Hello! I have a caller on the line who needs your assistance. May I brief you on the situation?",
"connected_message": "You are now connected with a supervisor. I'll leave you to it."
}
}
],
"is_webhook_active": true,
"webhook_url": "https://example.com/webhook",
"inbound_webhook_url": "https://example.com/inbound-webhook",
"language": "de",
"type": "outbound",
"status": "active",
"max_duration": 1800,
"record": true,
"initial_message": "Good day! I'm calling from Famulor...",
"system_prompt": "You are a friendly sales assistant...",
"flows_platform_id": null,
"timezone": "Europe/Berlin",
"created_at": "2024-01-15T10:30:00Z",
"updated_at": "2024-01-15T10:30:00Z",
"max_silence_duration": 3,
"reengagement_interval": 5,
"deleted_at": null,
"end_call_on_voicemail": 1,
"llm_temperature": "0.7",
"voice_stability": "0.8",
"voice_similarity": "0.9",
"allow_interruptions": true,
"enable_noise_cancellation": true,
"endpoint_sensitivity": 0.5,
"speech_speed": "1.0",
"endpoint_type": "vad",
"wait_for_customer": false,
"mode": "pipeline",
"language_id": 1,
"transcriber_provider_id": 1,
"synthesizer_provider_id": 1,
"llm_model_id": 1,
"multimodal_model_id": null,
"ambient_sound": "office",
"uuid": "550e8400-e29b-41d4-a716-446655440000",
"send_webhook_only_on_completed": true,
"include_recording_in_webhook": false,
"interrupt_sensitivity": 0.3,
"filler_config": {
"enabled": true,
"phrases": ["Hmm...", "I understand..."]
},
"knowledgebase_id": 100,
"knowledgebase_mode": "semantic",
"min_interrupt_words": 2,
"ambient_sound_volume": "0.3",
"widget_settings": {
"enabled": false
}
}
],
"current_page": 1,
"per_page": 10,
"total": 1,
"last_page": 1
}
Related pages: Introduction and Authentication Guide, and API Integration Examples.