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

# List calls

`GET /calls`

Returns a paginated list of calls for the specified model. You can optionally filter by time window, status, duration range, or phone number.

## Query parameters

- `model_id` string, required
- `limit` integer
- `offset` integer
- `from_date` integer
- `to_date` integer
- `call_status` string
- `duration_min` integer
- `duration_max` integer
- `lead_phone_number` string

## Headers

- `Authorization` string, required

## Response `200`

200

- ListCallsResponse200
  - `status` string — Whether the request was successful.
  - `response` CallsGetResponsesContentApplicationJsonSchemaResponse
    - `pagination` CallsGetResponsesContentApplicationJsonSchemaResponsePagination — Pagination information for the response
      - `total_records` integer — Total number of call records
      - `limit` integer — Maximum number of records per page
      - `offset` integer — Starting index for the current page
    - `calls` CallsGetResponsesContentApplicationJsonSchemaResponseCallsItems[]
      - `call_id` string — Call ID. You can find it on the logs page in your dashboard.
      - `model_id` string — Agent ID. You can find it on the agent’s page in your dashboard.
      - `duration` integer — Duration of the call in seconds
      - `end_call_reason` string — Reason why the call ended
      - `judge_results` unknown
      - `lead_phone_number` string — Phone number of the lead
      - `agents_used` string[] — List of agents used during the call
      - `executed_actions` CallsGetResponsesContentApplicationJsonSchemaResponseCallsItemsExecutedActions — Actions executed during the call
      - `recording_url` string, nullable
      - `type_of_call` string — Type of call (inbound or outbound)
      - `recording_duration` string, nullable — Duration of the recording
      - `transcript` string, nullable
      - `error_message` string, nullable — Error message if the call failed
      - `call_status` string — Status of the call
      - `start_time` string — Timestamp when the call started (milliseconds since epoch)
      - `lead_name` string, nullable — Name of the lead
      - `name` string, nullable — Name of the call recipient
      - `labels` string[] — Labels associated with the call
      - `agent_phone_number` string — Phone number used by the agent
      - `deployment_type` string, nullable — Type of deployment
      - `timezone` string, nullable — Timezone for the call
      - `telephony_hangup` 'caller' | 'callee'
      - `telephony_disconnect_reason` 'unknown' | 'callee_hangup' | 'caller_hangup' | 'error' | 'forbidden'
      - `telephony_duration` integer, nullable
      - `telephony_start` string, date, nullable
      - `telephony_end` string, date, nullable
      - `campaign_type` string
      - `phone_number_from` string
      - `phone_number_to` string
      - `collected_variables` object — Collected variables (slots) from the conversation flow, keyed by agent ID. May be null if not available.

## Other responses

- `400` — 400

---

[API](https://skmtc.net/synthflow/apis/platform-api.md) · [All operations](https://skmtc.net/synthflow/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/synthflow/platform-api/versions/decb652b52e0/schema)