> ## Documentation Index
> Fetch the complete documentation index at: https://koreai.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# API for Duration-Based Conversation Records
[Back to API List](/ai-for-service/apis/agent-ai/api-list)
Retrieves a paginated list of Agent AI conversation records within a specified date range. Each record includes the conversation transcript, AI-generated summaries, Agentic Copilot interactions, search history, and agent feedback.
The maximum duration supported for the date range is 7 days.
***
## API Details
| Parameter | Description |
| ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| **Method** | `POST` |
| **Endpoint** | `https://{{host}}/agentassist/api/v1/public/{{botid}}/aaconversation` |
| **Content Type** | `application/json` |
| **Authorization** | `auth: {{JWT}}`: See [How to generate the JWT Token](/ai-for-service/apis/automation/api-introduction#generating-the-jwt-token) |
| **Scope** | `AgentAssist Analytics`: See [Associate API Scopes](/ai-for-service/administration/security-and-control/api-scopes#supported-api-scopes) |
## Path Parameters
| Parameter | Required | Description |
| --------- | -------- | ----------------------------------------------------------------------------- |
| `host` | Yes | The environment URL. For example, `https://platform.kore.ai`. |
| `botid` | Yes | The unique bot identifier. Example: `st-79a76d65-d540-5b33-96d5-9bf3eebxxxxx` |
## Header Parameters
| Parameter | Type | Required | Description |
| ----------- | ------ | -------- | ------------------------------------------------------------- |
| `accountid` | String | Yes | Unique identifier of the customer account making the request. |
## Body Parameters
| Parameter | Type | Required | Description |
| ----------------------- | ------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `from` | String (YYYY-MM-DD) | Yes | Start date for fetching conversation records. |
| `to` | String (YYYY-MM-DD) | Yes | End date for fetching conversation records. |
| `page` | Integer | No | Page number for paginated results. Default: `1` |
| `limit` | Integer | No | Number of records per page. Maximum: `20`. |
| `includeHistory` | Boolean | No | If `true`, includes conversation history. Default: `false` |
| `includeAgenticHistory` | Boolean | No | If `true`, includes Agentic Copilot conversation history. Default: `false`. |
| `includeFeedback` | Boolean | No | If `true`, includes feedback in the response (for example, feedback on summary, Agentic suggestions, and overall widget performance). Default: `false`. |
| `includeSummary` | Boolean | No | If `true`, includes the conversation summary. Default: `false`. |
| `widgetLoaded` | Boolean | No | If true, includes widget loading status. Default: false. |
| `conversationIds` | String | No | Filters the response by conversation IDs. Default: false. |
## Sample Request
```bash theme={null}
curl --location --max-time 2000 --request POST 'https://{{host}}/agentassist/api/v1/public/{{botid}}/aaconversation'
--header 'accountId: 6798834e4e94062f75xxxxxx'
--header 'auth: eyJhbGciOiJIUzI1NiIsInR5cxxxxxxXVCJ9.eyJhcHBJZCI6ImNzLWM1M2VjMGZiLTkwYxxxxxxyZC04NTQ1LWRlYTJjMjdlYmFhMCJ9.CC3WptQkOyxxxxxxIVMLNETLchKSOAFMst47xxxxxxx'
--header 'Content-Type: application/json'
--data '{
"from": "2026-06-07",
"to": "2026-06-07",
"page": 1,
"limit": 20,
"includeHistory": true,
"includeAgenticHistory": true,
"includeFeedback": true,
"includeSummary": true,
“widgetLoaded”: true,
“conversationIds”: ["ates*********72"]
}'
```
## Sample Response
```json theme={null}
{
"results": [
{
"_id": "6a268bf57ee22fxxxxxxxx2c",
"convId": "CH9daxxxxxxxxd4917b70029c176fc088e",
"botId": "st-14bff9c5-b5f4-5c2d-a8e0-6xxxxxxxx941",
"isExtAD": true,
"startTime": "2026-06-08T09:31:33.410Z",
"summaries": [
{
"summaryId": "smr-76d3c59-4809-430a-86d1-b00xxxxxxxxd",
"participant": {
"identity": "an-acb8aca9-7a7c-45e5-be5f-98xxxxxxxx12",
"name": "Anonymous",
"type": "agent",
"startTime": [],
"endTime": []
},
"summary": "The customer requested to trigger a welcome event.",
"type": "interim",
"editedSummary": "The customer requested to trigger a welcome event.",
"generationTimeInSecs": 2.314,
"feedbackInfo": {
"agentDetails": {
"identity": "an-acb8aca9-7a7c-45e5-be5f-98**********",
"name": "Anonymous"
},
"feedback": "like",
"comment": "",
"feedbackDetails": [],
"type": "summary"
}
},
{
"summaryId": "smr-1dd57c1-178a-4c7a-90c0-9c**********",
"participant": {
"identity": "an-acb8aca9-7a7c-45e5-be5f-98**********",
"name": "Anonymous",
"type": "agent",
"startTime": [],
"endTime": []
},
"summary": "The customer requested to trigger a welcome event.",
"type": "final",
"generationTimeInSecs": 1.889,
"feedbackInfo": {
"agentDetails": {
"identity": "an-acb8aca9-7a7c-45e5-be5f-98**********",
"name": "Anonymous"
},
"feedback": "dislike",
"comment": "End of summary feedback and selected option as Not satisfactory",
"feedbackDetails": [
"Not Satisfactory"
],
"type": "summary"
}
}
],
"experience": "chat",
"messages": [
{
"_id": "ms-b82ebefb-e2e8-5680-8965-************",
"botId": "st-14bff9c5-b5f4-5c2d-a8e0-6**********1",
"accountId": "67a47c*********b3dae218b",
"components": [
{
"_id": "cp-32cbc598-6389-57f7-9379-**********7c",
"cT": "text",
"data": {
"text": "Customer requested: 'Trigger welcome event'."
},
"thumbnails": []
}
],
"createdOn": "2026-06-08T09:31:49.853Z",
"lmodifiedOn": "2026-06-08T09:31:49.853Z",
"ire": true,
"chnl": "agentassist",
"lang": "en",
"author": {
"id": "anonymousAgent",
"type": "AGENT"
},
"conversationId": "CH9da04**********7b70029c176fc088e",
"__lModifiedOn__": "2026-06-08T09:31:49.000Z",
"timestampValue": 1780911109865
},
{
"_id": "ms-88f8382e-b182**********-09b397722cf7",
"botId": "st-14bff9c5-b5f4-5c2d-a8e0-6********941",
"accountId": "67a47c**********3dae218b",
"components": [
{
"_id": "cp-d20780e0-bf61**********-3a964eaa6b32",
"cT": "text",
"data": {
"text": "personal loan."
},
"thumbnails": []
}
],
"createdOn": "2026-06-08T09:32:48.108Z",
"lmodifiedOn": "2026-06-08T09:32:48.108Z",
"ire": true,
"chnl": "agentassist",
"lang": "en",
"author": {
"type": "USER"
},
"conversationId": "CH9da04302**********0029c176fc088e",
"__lModifiedOn__": "2026-06-08T09:32:48.000Z",
"timestampValue": 1780911168117
},
{
"_id": "ms-f58c648c**********-9b2e-0dc828345db1",
"botId": "st-14bff9c5-**********a8e0-6294bf032941",
"accountId": "67a**********f3b3dae218b",
"components": [
{
"_id": "cp-d7b471ba-**********8ff7-8b4a1141b729",
"cT": "text",
"data": {
"text": "Customer says they cleared home loan and personal loan."
},
"thumbnails": []
}
],
"createdOn": "2026-06-08T09:33:12.692Z",
"lmodifiedOn": "2026-06-08T09:33:12.692Z",
"ire": true,
"chnl": "agentassist",
"lang": "en",
"author": {
"id": "anonymousAgent",
"type": "AGENT"
},
"conversationId": "CH9da043023**********029c176fc088e",
"__lModifiedOn__": "2026-06-08T09:33:12.000Z",
"timestampValue": 1780911192725
},
{
"_id": "ms-bb7ac015-07*******04-831766e6552e",
"botId": "st-14bff9c5-b5*********6294bf032941",
"accountId": "67*********b3dae218b",
"components": [
{
"_id": "cp-9b89**********dbd-9e36-311d62a32c49",
"cT": "text",
"data": {
"text": "I want to confirm a few things so I can help."
},
"thumbnails": []
}
],
"createdOn": "2026-06-08T09:35:02.027Z",
"lmodifiedOn": "2026-06-08T09:35:02.027Z",
"ire": true,
"chnl": "agentassist",
"lang": "en",
"author": {
"id": "anonymousAgent",
"type": "AGENT"
},
"conversationId": "CH9da043023f**********29c176fc088e",
"__lModifiedOn__": "2026-06-08T09:35:02.000Z",
"timestampValue": 1780911302062
}
],
"widgetFeedbacks": [
{
"agentDetails": {
"identity": "an-acb8aca9-7a7c**********-98a798cfca12",
"name": "Anonymous"
},
"feedback": "like",
"comment": "overall widget feedback",
"feedbackDetails": [
"Good Search Functionality "
],
"type": "widget"
}
]
}
],
"skip": 0,
"limit": 20,
"hasMore": false,
"totalPages": 1,
"totalResults": 9
}
```
## Response Body Parameters
| Parameter | Type | Description |
| ------------------------------------------------------ | ----------------- | -------------------------------------------------------------------------------- |
| `results` | Array | List of conversation objects retrieved. |
| `results._id` | String | Unique identifier of the conversation document. |
| `results.convId` | String | Conversation identifier. |
| `results.botId` | String | Identifier of the bot handling the conversation. |
| `results.isExtAD` | Boolean | Indicates whether the conversation is external. |
| `results.startTime` | String (ISO 8601) | Timestamp when the conversation started. |
| `results.experience` | String | Experience type, for example, `chat` or `voice`. |
| `results.summaries` | Array | List of conversation summary objects. |
| `results.summaries.summaryId` | String | Unique identifier of the summary. |
| `results.summaries.participant` | Object | Details of the agent associated with the summary. |
| `results.summaries.participant.identity` | String | Unique identifier of the agent. |
| `results.summaries.participant.name` | String | Name of the agent. |
| `results.summaries.participant.type` | String | Type of participant, for example, `agent`. |
| `results.summaries.summary` | String | AI-generated conversation summary. |
| `results.summaries.editedSummary` | String | (Optional) Edited version of the summary if an agent modified it. |
| `results.summaries.type` | String | Summary type, for example, `interim` or `final`. |
| `results.summaries.generationTimeInSecs` | Number | Time taken to generate the summary, in seconds. |
| `results.summaries.feedbackInfo` | Object | (Optional) Feedback the agent submitted on the summary. |
| `results.summaries.feedbackInfo.agentDetails` | Object | Details of the agent who submitted the feedback. |
| `results.summaries.feedbackInfo.agentDetails.identity` | String | Unique identifier of the agent. |
| `results.summaries.feedbackInfo.agentDetails.name` | String | Name of the agent. |
| `results.summaries.feedbackInfo.feedback` | String | Feedback value, for example, `like` or `dislike`. |
| `results.summaries.feedbackInfo.comment` | String | Free-text comment the agent entered with the feedback. |
| `results.summaries.feedbackInfo.feedbackDetails` | Array | List of feedback reasons the agent selected. |
| `results.summaries.feedbackInfo.type` | String | Feedback type, for example, `summary`. |
| `results.mbSessionId` | String | (Optional) Messaging backend session ID. |
| `results.mbUserId` | String | (Optional) Messaging backend user ID. |
| `results.messages` | Array | List of messages exchanged in the conversation. |
| `results.messages._id` | String | Unique identifier of the message. |
| `results.messages.type` | String | Message type, for example, `AGENTIC`. |
| `results.messages.botId` | String | Bot ID associated with the message. |
| `results.messages.accountId` | String | Account identifier associated with the message. |
| `results.messages.orgId` | String | Organization identifier associated with the message. |
| `results.messages.requestId` | String | Unique identifier of the Agentic request. |
| `results.messages.conversationId` | String | Conversation identifier associated with the message. |
| `results.messages.language` | String | Language of the message, for example, `en`. |
| `results.messages.query` | String | Customer query that triggered the Agentic suggestion. |
| `results.messages.components` | Array | List of message components, such as text or media. |
| `results.messages.components._id` | String | Unique identifier of the message component. |
| `results.messages.components.cT` | String | Component type, for example, `text`. |
| `results.messages.components.data` | Object | Data of the component, for example, `{ "text": "hi" }`. |
| `results.messages.components.thumbnails` | Array | List of thumbnails (if any) associated with the component. |
| `results.messages.isSent` | Boolean | Indicates whether the agent sent the suggestion to the customer. |
| `results.messages.isCopied` | Boolean | Indicates whether the agent copied the suggestion. |
| `results.messages.isOverride` | Boolean | Indicates whether the agent overrode the suggestion. |
| `results.messages.requestedAt` | String (ISO 8601) | Timestamp when the Agentic request was sent. |
| `results.messages.respondedAt` | String (ISO 8601) | Timestamp when Agentic Copilot responded. |
| `results.messages.triggeringMessageId` | String | Identifier of the message that triggered the Agentic suggestion. |
| `results.messages.createdOn` | String (ISO 8601) | Timestamp when the message was created. |
| `results.messages.author` | Object | Details of the message author. |
| `results.messages.author.type` | String | Type of the message author, for example, `USER` or `AGENT`. |
| `results.messages.author.id` | String | (Optional) Identifier of the message author. |
| `results.messages.timestampValue` | Integer | Unix timestamp of the message in milliseconds. |
| `results.messages.sessionInfo` | Object | Session details associated with the Agentic interaction. |
| `results.messages.sessionInfo.status` | String | Current session status, for example, `idle`. |
| `results.messages.sessionInfo.sessionId` | String | Unique session identifier. |
| `results.messages.sessionInfo.userId` | String | Unique user identifier for the session. |
| `results.messages.sessionInfo.runId` | String | Unique run identifier for the session. |
| `results.messages.sessionInfo.appId` | String | Identifier of the Agentic app. |
| `results.messages.sessionInfo.envId` | String | Identifier of the environment. |
| `results.messages.sessionInfo.envName` | String | Name of the environment, for example, `demo`. |
| `results.messages.sessionInfo.conversationState` | String | Current state of the conversation, for example, `AWAITING_INPUT` or `COMPLETED`. |
| `results.messages.sessionInfo.activeConversationAgent` | String | Name of the active Agentic conversation agent. |
| `results.messages.sessionInfo.source` | String | Source of the Agentic interaction, for example, `AIS-AA`. |
| `results.messages.feedbackInfo` | Object | (Optional) Feedback the agent submitted on the Agentic suggestion. |
| `results.messages.feedbackInfo.agentDetails` | Object | Details of the agent who submitted the feedback. |
| `results.messages.feedbackInfo.agentDetails.identity` | String | Unique identifier of the agent. |
| `results.messages.feedbackInfo.agentDetails.name` | String | Name of the agent. |
| `results.messages.feedbackInfo.feedback` | String | Feedback value, for example, `like` or `dislike`. |
| `results.messages.feedbackInfo.comment` | String | Free-text comment the agent entered with the feedback. |
| `results.messages.feedbackInfo.feedbackDetails` | Array | List of feedback reasons the agent selected. |
| `results.messages.feedbackInfo.type` | String | Feedback type, for example, `agentic`. |
| `results.searchHistory` | Array | List of Agentic search interactions the agent triggered manually. |
| `results.agenticAssistSessionIds` | Array | List of Agentic Copilot session IDs associated with the conversation. |
| `results.agenticSearchSessionIds` | Array | List of Agentic search session IDs associated with the conversation. |
| `results.widgetFeedbacks` | Array | List of overall widget feedback entries submitted by agents. |
| `results.widgetFeedbacks.agentDetails` | Object | Details of the agent who submitted the widget feedback. |
| `results.widgetFeedbacks.agentDetails.identity` | String | Unique identifier of the agent. |
| `results.widgetFeedbacks.agentDetails.name` | String | Name of the agent. |
| `results.widgetFeedbacks.feedback` | String | Feedback value, for example, `like` or `dislike`. |
| `results.widgetFeedbacks.comment` | String | Free-text comment the agent entered with the feedback. |
| `results.widgetFeedbacks.feedbackDetails` | Array | List of feedback reasons the agent selected. |
| `results.widgetFeedbacks.type` | String | Feedback type, for example, `widget`. |
| `skip` | Integer | Number of records skipped in the current response. |
| `limit` | Integer | Number of records returned per page. |
| `hasMore` | Boolean | Indicates whether more records are available beyond the current page. |
| `totalPages` | Integer | Total number of pages available. |
| `totalResults` | Integer | Total number of conversation records matching the query. |