Skip to main content
GET
/
api
/
user
/
calls
List Calls
curl --request GET \
  --url https://app.famulor.de/api/user/calls \
  --header 'Authorization: Bearer <token>'
{
  "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

​
status
string
Filter calls by status. Possible values: initiated, ringing, busy, in-progress, ended, completed, ended_by_customer, ended_by_assistant, no-answer, failed
​
type
string
Filter calls by type. Possible values: inbound, outbound, web
​
phone_number
string
Filter calls by client phone number
​
assistant_id
integer
Filter calls by assistant ID
​
campaign_id
integer
Filter calls by campaign ID
​
date_from
string
Filter calls from this date (YYYY-MM-DD format)
​
date_to
string
Filter calls up to this date (YYYY-MM-DD format)
​
per_page
integer
Number of calls per page (1-100, default: 15)
​
page
integer
Page number (default: 1)

​
Response Fields

​
data
array
Array of calls
​
current_page
integer
The current page number
​
per_page
integer
Number of items per page
​
total
integer
Total number of calls matching the criteria
​
last_page
integer
The last page number
​
first_page_url
string
URL of the first page
​
last_page_url
string
URL of the last page
​
next_page_url
string
URL of the next page, or null
​
prev_page_url
string
URL of the previous page, or null
​
path
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.