List Calls
curl --request GET \
--url https://app.famulor.de/api/user/callsimport requests
url = "https://app.famulor.de/api/user/calls"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://app.famulor.de/api/user/calls', 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/calls",
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/calls"
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/calls")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.famulor.de/api/user/calls")
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": 123456,
"assistant_name": "Sales Assistant",
"campaign_name": "Neukundenakquise Q1 2024",
"type": "outbound",
"duration": 180,
"assistant_phone_number": "+4912345678",
"client_phone_number": "+4915123456789",
"status": "completed",
"transcript": [
{
"text": "Hallo, mein Name ist Maximilian, ich melde mich im Auftrag eines IT-Unternehmens.",
"type": "transcript",
"sender": "bot",
"timestamp": 1754055268.525861
},
{
"text": "Hallo?",
"type": "transcript",
"sender": "human",
"timestamp": 1754055272.069057
}
],
"variables": {
"customer_name": "John"
},
"evaluation": [
{
"name": "status",
"type": "bool",
"value": true,
"description": "Whether the call objective was achieved or not."
},
{
"name": "summary",
"type": "string",
"value": "Connected to the customer, obtained name of the person responsible for IT.",
"description": "Call summary in a few words."
}
],
"webhook_response": {
"crm_updated": true,
"lead_score": 75
},
"carrier_cost": "0.08000000",
"total_cost": "0.12000000",
"answered_by": "human",
"recording_url": "https://recordings.famulor.de/call-123456.mp3",
"created_at": "2024-01-15T10:30:00Z",
"updated_at": "2024-01-15T10:33:00Z"
},
{
"id": 123457,
"assistant_name": "Support Assistant",
"campaign_name": null,
"type": "inbound",
"duration": 120,
"assistant_phone_number": "+4912345678",
"client_phone_number": "+4917123456789",
"status": "ended_by_customer",
"transcript": [
{
"text": "Kunde: Hallo, ich habe eine Frage zu meinem Konto.",
"type": "transcript",
"sender": "human",
"timestamp": 1754055300.123456
},
{
"text": "Gerne helfe ich Ihnen dabei. Was kann ich für Sie tun?",
"type": "transcript",
"sender": "bot",
"timestamp": 1754055302.789012
}
],
"variables": {
"issue_resolved": true,
"satisfaction_rating": 9
},
"evaluation": [
{
"name": "issue_resolved",
"type": "bool",
"value": true,
"description": "Whether the customer's issue was resolved."
},
{
"name": "satisfaction_rating",
"type": "integer",
"value": 9,
"description": "Customer satisfaction rating from 1-10."
}
],
"webhook_response": null,
"carrier_cost": "0.05000000",
"total_cost": "0.08000000",
"answered_by": "human",
"recording_url": null,
"created_at": "2024-01-15T14:20:00Z",
"updated_at": "2024-01-15T14:22:00Z"
}
],
"current_page": 1,
"first_page_url": "https://app.famulor.de/api/user/calls?page=1",
"from": 1,
"last_page": 4,
"last_page_url": "https://app.famulor.de/api/user/calls?page=4",
"links": [
{
"url": null,
"label": "« Previous",
"active": false
},
{
"url": "https://app.famulor.de/api/user/calls?page=1",
"label": "1",
"active": true
}
],
"next_page_url": "https://app.famulor.de/api/user/calls?page=2",
"path": "https://app.famulor.de/api/user/calls",
"per_page": 15,
"prev_page_url": null,
"to": 15,
"total": 52
}
Calls
List Calls
List all calls for the authenticated user with filtering options
GET
/
api
/
user
/
calls
List Calls
curl --request GET \
--url https://app.famulor.de/api/user/callsimport requests
url = "https://app.famulor.de/api/user/calls"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://app.famulor.de/api/user/calls', 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/calls",
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/calls"
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/calls")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.famulor.de/api/user/calls")
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": 123456,
"assistant_name": "Sales Assistant",
"campaign_name": "Neukundenakquise Q1 2024",
"type": "outbound",
"duration": 180,
"assistant_phone_number": "+4912345678",
"client_phone_number": "+4915123456789",
"status": "completed",
"transcript": [
{
"text": "Hallo, mein Name ist Maximilian, ich melde mich im Auftrag eines IT-Unternehmens.",
"type": "transcript",
"sender": "bot",
"timestamp": 1754055268.525861
},
{
"text": "Hallo?",
"type": "transcript",
"sender": "human",
"timestamp": 1754055272.069057
}
],
"variables": {
"customer_name": "John"
},
"evaluation": [
{
"name": "status",
"type": "bool",
"value": true,
"description": "Whether the call objective was achieved or not."
},
{
"name": "summary",
"type": "string",
"value": "Connected to the customer, obtained name of the person responsible for IT.",
"description": "Call summary in a few words."
}
],
"webhook_response": {
"crm_updated": true,
"lead_score": 75
},
"carrier_cost": "0.08000000",
"total_cost": "0.12000000",
"answered_by": "human",
"recording_url": "https://recordings.famulor.de/call-123456.mp3",
"created_at": "2024-01-15T10:30:00Z",
"updated_at": "2024-01-15T10:33:00Z"
},
{
"id": 123457,
"assistant_name": "Support Assistant",
"campaign_name": null,
"type": "inbound",
"duration": 120,
"assistant_phone_number": "+4912345678",
"client_phone_number": "+4917123456789",
"status": "ended_by_customer",
"transcript": [
{
"text": "Kunde: Hallo, ich habe eine Frage zu meinem Konto.",
"type": "transcript",
"sender": "human",
"timestamp": 1754055300.123456
},
{
"text": "Gerne helfe ich Ihnen dabei. Was kann ich für Sie tun?",
"type": "transcript",
"sender": "bot",
"timestamp": 1754055302.789012
}
],
"variables": {
"issue_resolved": true,
"satisfaction_rating": 9
},
"evaluation": [
{
"name": "issue_resolved",
"type": "bool",
"value": true,
"description": "Whether the customer's issue was resolved."
},
{
"name": "satisfaction_rating",
"type": "integer",
"value": 9,
"description": "Customer satisfaction rating from 1-10."
}
],
"webhook_response": null,
"carrier_cost": "0.05000000",
"total_cost": "0.08000000",
"answered_by": "human",
"recording_url": null,
"created_at": "2024-01-15T14:20:00Z",
"updated_at": "2024-01-15T14:22:00Z"
}
],
"current_page": 1,
"first_page_url": "https://app.famulor.de/api/user/calls?page=1",
"from": 1,
"last_page": 4,
"last_page_url": "https://app.famulor.de/api/user/calls?page=4",
"links": [
{
"url": null,
"label": "« Previous",
"active": false
},
{
"url": "https://app.famulor.de/api/user/calls?page=1",
"label": "1",
"active": true
}
],
"next_page_url": "https://app.famulor.de/api/user/calls?page=2",
"path": "https://app.famulor.de/api/user/calls",
"per_page": 15,
"prev_page_url": null,
"to": 15,
"total": 52
}
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
string
Filter calls by status. Possible values:
initiated, ringing, busy, in-progress, ended, completed, ended_by_customer, ended_by_assistant, no-answer, failedstring
Filter calls by type. Possible values:
inbound, outbound, webstring
Filter calls by client phone number
integer
Filter calls by assistant ID
integer
Filter calls by campaign ID
string
Filter calls from this date (YYYY-MM-DD format)
string
Filter calls up to this date (YYYY-MM-DD format)
integer
Number of calls per page (1-100, default: 15)
integer
Page number (default: 1)
Response Fields
array
Array of calls
Show Call Properties
Show Call Properties
integer
The unique identifier of the call
string
The name of the assistant who handled the call
string
The name of the campaign to which this call belongs (if applicable)
string
The type of the call (inbound, outbound, or web)
integer
The duration of the call in seconds
string
The phone number used by the assistant
string
The client’s phone number
string
The current status of the call
array
The transcript of the call conversation as an array of objects containing text, type, sender, and timestamp
object
Variables collected during the call
array
Evaluation data for call performance as an array of objects with name, type, value, and description
object
Response from configured webhooks
string
The cost charged by the carrier for this call
string
The total cost of the call including all fees
string
Who answered the call (human, machine, or unknown)
string
URL to the call recording (if available and enabled)
string
Date and time when the call was created
string
Date and time of the last update to the call
integer
The current page number
integer
Number of items per page
integer
Total number of calls matching the criteria
integer
The last page number
string
URL of the first page
string
URL of the last page
string
URL of the next page, or
nullstring
URL of the previous page, or
nullstring
Base pagination path
{
"data": [
{
"id": 123456,
"assistant_name": "Sales Assistant",
"campaign_name": "Neukundenakquise Q1 2024",
"type": "outbound",
"duration": 180,
"assistant_phone_number": "+4912345678",
"client_phone_number": "+4915123456789",
"status": "completed",
"transcript": [
{
"text": "Hallo, mein Name ist Maximilian, ich melde mich im Auftrag eines IT-Unternehmens.",
"type": "transcript",
"sender": "bot",
"timestamp": 1754055268.525861
},
{
"text": "Hallo?",
"type": "transcript",
"sender": "human",
"timestamp": 1754055272.069057
}
],
"variables": {
"customer_name": "John"
},
"evaluation": [
{
"name": "status",
"type": "bool",
"value": true,
"description": "Whether the call objective was achieved or not."
},
{
"name": "summary",
"type": "string",
"value": "Connected to the customer, obtained name of the person responsible for IT.",
"description": "Call summary in a few words."
}
],
"webhook_response": {
"crm_updated": true,
"lead_score": 75
},
"carrier_cost": "0.08000000",
"total_cost": "0.12000000",
"answered_by": "human",
"recording_url": "https://recordings.famulor.de/call-123456.mp3",
"created_at": "2024-01-15T10:30:00Z",
"updated_at": "2024-01-15T10:33:00Z"
},
{
"id": 123457,
"assistant_name": "Support Assistant",
"campaign_name": null,
"type": "inbound",
"duration": 120,
"assistant_phone_number": "+4912345678",
"client_phone_number": "+4917123456789",
"status": "ended_by_customer",
"transcript": [
{
"text": "Kunde: Hallo, ich habe eine Frage zu meinem Konto.",
"type": "transcript",
"sender": "human",
"timestamp": 1754055300.123456
},
{
"text": "Gerne helfe ich Ihnen dabei. Was kann ich für Sie tun?",
"type": "transcript",
"sender": "bot",
"timestamp": 1754055302.789012
}
],
"variables": {
"issue_resolved": true,
"satisfaction_rating": 9
},
"evaluation": [
{
"name": "issue_resolved",
"type": "bool",
"value": true,
"description": "Whether the customer's issue was resolved."
},
{
"name": "satisfaction_rating",
"type": "integer",
"value": 9,
"description": "Customer satisfaction rating from 1-10."
}
],
"webhook_response": null,
"carrier_cost": "0.05000000",
"total_cost": "0.08000000",
"answered_by": "human",
"recording_url": null,
"created_at": "2024-01-15T14:20:00Z",
"updated_at": "2024-01-15T14:22:00Z"
}
],
"current_page": 1,
"first_page_url": "https://app.famulor.de/api/user/calls?page=1",
"from": 1,
"last_page": 4,
"last_page_url": "https://app.famulor.de/api/user/calls?page=4",
"links": [
{
"url": null,
"label": "« Previous",
"active": false
},
{
"url": "https://app.famulor.de/api/user/calls?page=1",
"label": "1",
"active": true
}
],
"next_page_url": "https://app.famulor.de/api/user/calls?page=2",
"path": "https://app.famulor.de/api/user/calls",
"per_page": 15,
"prev_page_url": null,
"to": 15,
"total": 52
}
Related pages: Introduction and Authentication Guide, and API Integration Examples.