---
title: "List Calls"
method: GET
path: "/user/calls"
tags: ["Calls"]
---

# List Calls

`GET /user/calls`

## Request

- Base URL: `https://app.famulor.de/api`
- URL: `https://app.famulor.de/api/user/calls`
- Auth: HTTP bearer

List all calls for the authenticated user with filtering options

[Docs](https://docs.famulor.io/api-v1/calls/list)

## Query parameters

- `status` 'initiated' | 'ringing' | 'busy' | 'in-progress' | 'ended' | 'completed' | 'ended_by_customer' | 'ended_by_assistant' | 'no-answer' | 'failed'
- `type` 'inbound' | 'outbound' | 'web'
- `phone_number` string
- `assistant_id` integer
- `campaign_id` integer
- `date_from` string
- `date_to` string
- `per_page` integer
- `page` integer

## Response `200`

Response

- object
  - `data` object[]: Array of calls
    - `id` integer: The unique identifier of the call
    - `assistant_name` string: The name of the assistant who handled the call
    - `campaign_name` string, nullable: The name of the campaign to which this call belongs (if applicable)
    - `type` string: The type of the call (inbound, outbound, or web)
    - `duration` integer: The duration of the call in seconds
    - `assistant_phone_number` string: The phone number used by the assistant
    - `client_phone_number` string: The client's phone number
    - `status` string: The current status of the call
    - `transcript` unknown[]: The transcript of the call conversation as an array of objects containing text, type, sender, and timestamp
      - unknown
    - `variables` object: Variables collected during the call
    - `evaluation` unknown[]: Evaluation data for call performance as an array of objects with name, type, value, and description
      - unknown
    - `webhook_response` object, nullable: Response from configured webhooks
    - `carrier_cost` string: The cost charged by the carrier for this call
    - `total_cost` string: The total cost of the call including all fees
    - `answered_by` string: Who answered the call (human, machine, or unknown)
    - `recording_url` string, nullable: URL to the call recording (if available and enabled)
    - `created_at` string: Date and time when the call was created
    - `updated_at` string: Date and time of the last update to the call
  - `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, nullable: URL of the previous page, or `null`
  - `path` string: Base pagination path

## Other responses

- `401`: Fehlender oder ungültiger API-Key.
- `422`: Die Anfrage ist inhaltlich ungültig.

---

[API](https://skmtc.dev/famulor/apis/famulor-api.md) · [All operations](https://skmtc.dev/famulor/apis/famulor-api/llms.txt) · [OpenAPI document](https://skmtc.dev/famulor/apis/famulor-api/revisions/3b938c370721?raw)