v51

latestOpenAPI 3.0.1MITraw.githubusercontent.com2026-08-01150230854.3 KB
Calls

List calls with transcripts

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.

post/calls/search

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.

Example:2.14

Request body

conversation_idsstring[] required

A list of conversation ids to fetch calls for. Maximum 20.

Response

successful

typestring

Example response

{
  "type": "list",
  "data": [
    {
      "type": "call",
      "id": "123",
      "conversation_id": "456",
      "admin_id": "789",
      "contact_id": "6762f0dd1bb69f9f2193bb83",
      "state": "completed",
      "recording_url": "https://api.intercom.io/calls/123/recording",
      "transcription_url": "https://api.intercom.io/calls/123/transcript",
      "call_type": "phone",
      "direction": "outbound",
      "ended_reason": "completed",
      "phone": "+15551234567"
    }
  ]
}