Intercom API (unofficial showcase)
POST/calls/search

List calls with transcripts

Lists calls associated with the specified conversation IDs and includes transcripts when available. Supply between 1 and 20 IDs in conversation_ids to retrieve the matching calls. Use this endpoint when you need call details and transcript availability for a set of conversations.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

1 parameter · 1 body field
Intercom-Versionstringoptional
The Intercom API version to use. Defaults to 2.17 when omitted.
Allowed:1.01.11.21.31.42.02.12.22.32.42.52.6Default:2.17

Search criteria containing the conversation IDs to retrieve calls for.

conversation_idsarray<string>required
A list of conversation ids to fetch calls for. Maximum 20.

3 status codes
200Returns a list of call objects associated with the supplied conversation IDs, including transcripts when available.
typestringoptional
dataarray<object>optional
400Returned when `conversation_ids` is missing or contains fewer than 1 or more than 20 IDs.

One documented failure

  • conversation_id_limit_exceeded

    A list of up to 20 conversation IDs is required

typestringrequired
The type is error.list
request_idstringoptional
errorsarray<object>required
An array of one or more error objects
401Returned when the request is unauthorized.

One documented failure

  • unauthorized

    Access Token Invalid

typestringrequired
The type is error.list
request_idstringoptional
errorsarray<object>required
An array of one or more error objects

Error handling

A 400 is returned when conversation_ids is missing, empty, or contains more than 20 IDs. A 401 is returned when the request is unauthorized.