---
title: "List calls with transcripts"
method: POST
path: "/calls/search"
tags: ["Calls"]
---

# List calls with transcripts

`POST /calls/search`

Retrieve calls by a list of conversation ids and include transcripts when available.
A maximum of 20 `conversation_ids` can be provided. If none are provided or more than 20 are provided, a 400 error is returned.

## Headers

- `Intercom-Version` '1.0' | '1.1' | '1.2' | '1.3' | '1.4' | '2.0' | '2.1' | '2.2' | '2.3' | '2.4' | '2.5' | '2.6' | '2.7' | '2.8' | '2.9' | '2.10' | '2.11' | '2.12' | '2.13' | '2.14' — Intercom API version.</br>By default, it's equal to the version set in the app package.

## Request body

- object
  - `conversation_ids` string[], required — A list of conversation ids to fetch calls for. Maximum 20.

## Response `200`

successful

- object
  - `type` string
  - `data` object[]
    - `type` string — String representing the object's type. Always has the value `call`.
    - `id` string — The id of the call.
    - `conversation_id` string, nullable — The id of the conversation associated with the call, if any.
    - `admin_id` string, nullable — The id of the admin associated with the call, if any.
    - `contact_id` string, nullable — The id of the contact associated with the call, if any.
    - `state` string — The current state of the call.
    - `initiated_at` union
      - string, date-time — A date and time following the ISO8601 notation.
      - integer — A date and time as UNIX timestamp notation.
    - `answered_at` union
      - string, date-time — A date and time following the ISO8601 notation.
      - integer — A date and time as UNIX timestamp notation.
    - `ended_at` union
      - string, date-time — A date and time following the ISO8601 notation.
      - integer — A date and time as UNIX timestamp notation.
    - `created_at` union
      - string, date-time — A date and time following the ISO8601 notation.
      - integer — A date and time as UNIX timestamp notation.
    - `updated_at` union
      - string, date-time — A date and time following the ISO8601 notation.
      - integer — A date and time as UNIX timestamp notation.
    - `recording_url` string, uri, nullable — API URL to download or redirect to the call recording if available.
    - `transcription_url` string, uri, nullable — API URL to download or redirect to the call transcript if available.
    - `call_type` string — The type of call.
    - `direction` string — The direction of the call.
    - `ended_reason` string, nullable — The reason for the call end, if applicable.
    - `phone` string, nullable — The phone number involved in the call, in E.164 format.
    - `fin_recording_url` string, uri, nullable — API URL to the AI Agent (Fin) call recording if available.
    - `fin_transcription_url` string, uri, nullable — API URL to the AI Agent (Fin) call transcript if available.
    - `transcript` object[] — The call transcript if available, otherwise an empty array.
    - `transcript_status` string, nullable — The status of the transcript if available.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized

---

[API](https://skmtc.net/intercom/apis/intercom-api.md) · [All operations](https://skmtc.net/intercom/apis/intercom-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/intercom/intercom-api/revisions/9517e80f2642/schema)