provider Conversations GET /conversations/{conversation_id}
@utdk/intercom /conversations/{conversation_id}
Retrieve a conversation
You can fetch the details of a single conversation. This will return a single Conversation model with all its conversation parts. {% admonition type="warning" name="Hard limit of 500 parts" %} The maximum number of conversation parts that can be returned via the API is 500. If you have more than that we will return the 500 most recent conversation parts. {% /admonition %} For AI agent conversation metadata, please note that you need to have the agent enabled in your workspace, which is a [paid feature](https://www.intercom.com/help/en/articles/8205718-fin-resolutions#h_97f8c2e671).
Intercom-Version header
enum: 1.0, 1.1, 1.2, 1.3…
conversation_id path required
The id of the conversation to target
integer
display_as query
Set to plaintext to retrieve conversation messages in plain text.
string
include_translations query
If set to true, conversation parts will be translated to the detected language of the conversation.
boolean

Try it

Authentication
Configure credentials for Intercom API
Gateway
The gateway proxies requests and injects credentials server-side. Configure credentials above, then enter your gateway URL.

Saved automatically to browser storage.

retrieveconversation
GET/conversations/{conversation_id}
You can fetch the details of a single conversation. This will return a single Conversation model with all its conversation parts. {% admonition type="warning" name="Hard limit of 500 parts" %} The maximum number of conversation parts that can be returned via the API is 500. If you have more than that we will return the 500 most recent conversation parts. {% /admonition %} For AI agent conversation metadata, please note that you need to have the agent enabled in your workspace, which is a [paid feature](https://www.intercom.com/help/en/articles/8205718-fin-resolutions#h_97f8c2e671).

Parameters

required

The id of the conversation to target

Set to plaintext to retrieve conversation messages in plain text.

If set to true, conversation parts will be translated to the detected language of the conversation.

Enter a gateway URL above to enable sending.

Code snippet
Updates live as you fill in the form above.

TypeScript

import intercom from '@utdk/intercom';

await intercom.retrieveconversation({
  "Intercom-Version": "2.14"
})