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

# List Calls

`GET /calls/v1/conversations`

This API will return the list of calls based on the filter criteria.

## Query parameters

- `startDate` string, date-time, required
- `endDate` string, date-time, required
- `page` integer
- `size` integer
- `sort` 'startAt' | 'endAt' | 'status' | 'conversationId'

## Response `200`

Successful response

- object
  - `totalCount` integer — Total number of calls without applying pagination.
  - `conversations` Conversation[]
    - `id` string — Unique identifier of the call
    - `teamId` string — Unique identifier of the team
    - `assistantId` string — Unique identifier of the assistant
    - `callType` 'web' | 'phone' — This is the type of the call.
    - `direction` 'inbound' | 'outbound'
    - `startAt` string, date-time — This is the ISO 8601 date-time string indicating when the record was initiated.
    - `endAt` string, date-time — This is the ISO 8601 date-time string of when the record was ended.
    - `userNumber` string — Phone number of the user
    - `assistantNumber` string — Phone number of the assistant
    - `status` 'queued' | 'ongoing' | 'forwarded' | 'finished' — This field indicates the status of the call.
    - `phoneCallStatus` 'trying' | 'early-media' | 'ringing' | 'in-progress' | 'busy' | 'no-answer' | 'failed' | 'completed' — Status of the phone call. A call can have one of the following statuses: - `trying`: The call has been initiated. - `early-media`: The call is playing an early media message or tone. - `ringing`: The recipient's phone is ringing. - `in-progress`: The call is currently active. - `busy`: The recipient is unavailable to answer. - `no-answer`: The call was not answered. - `failed`: The call attempt was unsuccessful. - `completed`: The call has ended.
    - `callEndTriggerBy` 'user' | 'assistant' — This is the trigger of the call end.
    - `monitor` ConversationMonitor — To monitor and control the conversation
      - `controlUrl` string — The URL to control the conversation
    - `analysis` ConversationAnalysis
      - `summary` string — This is the summary of the call. Customize by setting `assistant.analysis.summary`.
      - `successEvaluation` string — This is the evaluation of the call. Customize by setting `assistant.analysis.successEvaluation.prompt` and/or `assistant.analysis.successEvaluation.rubric`.
      - `structuredData` object — This is the structured data extracted from the call. Customize by setting `assistant.analysis.structuredData.prompt `and/or `assistant.analysisPlan.structuredData.schema`.

---

[API](https://skmtc.dev/interactly/apis/interactly-api.md) · [All operations](https://skmtc.dev/interactly/apis/interactly-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/interactly/interactly-api/revisions/8a408fde89f6/schema)