List Calls

curl --request GET \
  --url https://app.famulor.de/api/user/calls \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

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

import requests

url = "https://app.famulor.de/api/user/calls"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

<?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",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$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)

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(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": "&laquo; 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
}

GET

api

user

calls

List Calls

curl --request GET \
  --url https://app.famulor.de/api/user/calls \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

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

import requests

url = "https://app.famulor.de/api/user/calls"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

<?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",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$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)

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(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": "&laquo; 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
}

This endpoint allows you to list all calls belonging to the authenticated user with various filtering options.

Query Parameters

string

Filter calls by status. Possible values: initiated, ringing, busy, in-progress, ended, completed, ended_by_customer, ended_by_assistant, no-answer, failed

string

Filter calls by type. Possible values: inbound, outbound, web

string

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

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 null

string

URL of the previous page, or null

string

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": "&laquo; 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.

Delete SIP Trunk Get Call

API Reference

AI Assistants

Folders

Labels

Leads

Campaigns

Mid Call Actions

AI Chatbot

AI Replies

Knowledgebases

SMS

WhatsApp

Phone Numbers

SIP Trunks

Calls

Webhooks

List Calls

Query Parameters

Response Fields

​Query Parameters

​Response Fields

Query Parameters

Response Fields