List calls with transcripts

Request

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.

Requires the read_conversations OAuth scope.

Security

bearerAuth

Intercom-Versionstring(intercom_version)

Intercom API version.
If you omit the header, the API uses the version set in your app package, and 1.0 if none is set.

Enum:"1.0""1.1""1.2""1.3""1.4""2.0""2.1""2.2""2.3""2.4"

Example:2.17

Bodyapplication/jsonrequired

conversation_idsArray of strings, [ 1 .. 20 ] itemsrequired

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

curl -i -X POST \
  https://api.intercom.io/calls/search \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -H 'Intercom-Version: 2.17' \
  -d '{
    "conversation_ids": [
      "64619700005694",
      "64619700005695"
    ]
  }'

Responses

successful

Bodyapplication/json

typestring

Example:"list"

dataArray of objects(Call)

Response

{
  "type": "list",
  "data": [
    { … }
  ]
}