> ## 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](https://koreai.mintlify.site/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.

> [!NOTE]
>
> 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](https://koreai.mintlify.site/ai-for-service/apis/automation/api-introduction.md#generating-the-jwt-token) |
| **Scope** | `AgentAssist Analytics`: See [Associate API Scopes](https://koreai.mintlify.site/ai-for-service/administration/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 response artifacts 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 expandable=true theme={null}
curl --location --max-time 2000 --request POST 'https://{{host}}/agentassist/api/v1/public/{{botid}}/aaconversation' 
--header 'accountId: {{accountId}}' 
--header 'auth: {{JWT_TOKEN}}' 
--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 expandable=true theme={null}
{
  "results": [
    {
      "_id": "6a94b************7e-c4a4f9b",
      "convId": "atest******lljlf",
      "botId": "st-354aa94b************7e-6aaf5ce59c",
      "isExtAD": true,
      "startTime": "2026-09-08T11:40:35.729Z",
      "summaries": [
        {
          "type": "landing",
          "summary": "Unable to fetch the summary. Please try after some time.",
          "generatedAt": "2026-09-08T11:40:35.802Z"
        }
      ],
      "isLoaded": true,
      "aaSessionId": "6a9f4b************7e-c370bd",
      "aaUserId": "u-1f24c4b************7e-e3a71ed22967",
      "experience": "chat",
      "messages": [
        {
          "_id": "6a9f4b************7e-6bdbcc6",
          "type": "AGENTIC",
          "timestampValue": 17*******3851,
          "requestId": "aa-58ee74b************7e--c177da4832e6",
          "conversationId": "atest*****jlf",
          "botId": "st-354aa4b************7e-46aaf5ce59c",
          "accountId": "6a344b************7e-f4bad04a",
          "orgId": "o-f4ba2e4b************7e--97330540cb59",
          "experience": "chat",
          "language": "en",
          "query": "Trigger welcome event",
          "components": {
            "_id": "cp-cd094b************7e-2bcd2a170d03",
            "cT": "text",
            "data": {
              "text": "Subject: Welcome to Our Service"
            }
          },
          "triggeringMessageId": null,
          "isSent": false,
          "isCopied": false,
          "interacted": false,
          "artifacts": [
            [
              {
                "id": "order_details",
                "header": "INTERNAL MESSAGE TO AGENT",
                "content": "Order Number ",
                "artifactId": "art-dd474b************7e-b-79371d69dbc5",
                "activities": [
                  {
                    "action": "expand",
                    "timestamp": "2026-09-03T10:52:17.212Z",
                    "agentId": "a-m****usj"
                  }
                ]
              },
              {
                "id": "internal_message",
                "header": "INTERNAL MESSAGE TO AGENT",
                "content": "The customer has requested a replacement",
                "artifactId": "art-b0a4b************7e-2-008c675a5398",
                "activities": [
                  {
                    "action": "expand",
                    "timestamp": "2026-09-03T10:52:18.441Z",
                    "agentId": "a-mt****sj"
                  }
                ],
                "feedbackInfo": {
                  "agentDetails": {
                    "identity": "a-m****usj",
                    "name": "Anonymous"
                  },
                  "feedback": "like",
                  "comment": "",
                  "feedbackDetails": [],
                  "type": "artifact"
                }
              },
              {
                "id": "kb_article_link",
                "header": "POLICY ARTICLE LINK",
                "content": "https://example.com",
                "artifactId": "art-114b************7e-249-40ec509855a1",
                "activities": [
                  {
                    "action": "expand",
                    "timestamp": "2026-09-03T10:52:22.890Z",
                    "agentId": "a-m****usj"
                  },
                  {
                    "action": "url_clicked",
                    "timestamp": "2026-09-03T10:52:23.982Z",
                    "agentId": "a-m****usj",
                    "url": "https://example.com"
                  }
                ]
              }
            ]
          ],
          "isOverride": false,
          "requestedAt": "2026-09-08T11:40:43.848Z",
          "respondedAt": "2026-09-08T11:40:49.912Z",
          "agentId": "a-m****usj",
          "sessionInfo": {
            "status": "idle",
            "userReference": "atesta****ljlf",
            "sessionReference": "ate****tslljlf",
            "userId": "u-fb77d524b************7e-658811874a41",
            "sessionId": "s-c4b4b************7e-a-5f901a0d9bed",
            "runId": "r-e17d4b************7e-4bdd17808843",
            "appId": "aa-5858d4b************7e-0eb67be6bd9e",
            "envId": "env-fad44b************7e-709c0ee5d8ef",
            "envName": "Dev",
            "conversationState": "COMPLETED",
            "voiceAgentSwitch": {
              "agentName": null,
              "taskStatus": "COMPLETED"
            },
            "attachments": [],
            "source": "AIS-AA",
            "activeConversationAgent": null
          }
        },
        {
          "_id": "ms-7a6019e4b************7e-3-d980123dcdec",
          "botId": "st-354aa98f4b************7e-046aaf5ce59c",
          "accountId": "6a4b************7e-7f4bad04a",
          "components": [
            {
              "_id": "cp-57cf4b************7e--ef819a753db4",
              "cT": "text",
              "data": {
                "text": "could you please write an email regarding leave "
              },
              "thumbnails": []
            }
          ],
          "createdOn": "2026-09-08T11:41:04.514Z",
          "lmodifiedOn": "2026-09-08T11:41:04.514Z",
          "ire": true,
          "chnl": "agentassist",
          "lang": "en",
          "author": {
            "type": "USER"
          },
          "conversationId": "atest******ljlf",
          "__lModifiedOn__": "2026-09-08T11:41:04.000Z",
          "timestampValue": 178******4527
        },
        {
          "_id": "6a4b************7e-4f6bdbd49",
          "type": "AGENTIC",
          "timestampValue": 178*******4800,
          "requestId": "aa-8a21c54b************7e-85-5f44d60d88ac",
          "conversationId": "atest******ljlf",
          "botId": "st-3544b************7e-a76b-046aaf5ce59c",
          "accountId": "6a4b************7e-7f4bad04a",
          "orgId": "o-f4ba2e4c-14b************7e-7330540cb59",
          "experience": "chat",
          "language": "en",
          "query": "could you please write an email regarding leave ",
          "components": {
            "_id": "cp-af4df7fd-4b************7e--c4e0d7f93b0d",
            "cT": "text",
            "data": {
              "text": "Subject: Leave Request"
            }
          },
          "triggeringMessageId": "ms-74b************7e-0-aef3-d980123dcdec",
          "isSent": false,
          "isCopied": false,
          "isOverride": false,
          "requestedAt": "2026-09-08T11:41:04.798Z",
          "respondedAt": "2026-09-08T11:41:10.702Z",
          "sessionInfo": {
            "status": "idle",
            "userReference": "atest*****ljlf",
            "sessionReference": "ate*****tslljlf",
            "userId": "u-fb77d5254b************7e-8-658811874a41",
            "sessionId": "s-c4b4b************7e-21a-5f901a0d9bed",
            "runId": "r-fe5bec564b************7e--be8b0ed3134f",
            "appId": "aa-5858db24b************7e-1-0eb67be6bd9e",
            "envId": "env-fad4b************7e-709c0ee5d8ef",
            "envName": "Dev",
            "conversationState": "COMPLETED",
            "voiceAgentSwitch": {
              "agentName": null,
              "taskStatus": "COMPLETED"
            },
            "attachments": [],
            "source": "AIS-AA",
            "activeConversationAgent": null
          }
        }
      ],
      "searchHistory": [],
      "agenticAssistSessionIds": [
        "s-c4b5ae0b-**********-5f901a0d9bed"
      ],
      "agenticSearchSessionIds": [],
      "widgetFeedbacks": []
    },
    {
      "_id": "6a9ff**********8c4a4f5d",
      "convId": "atest******ljlf",
      "botId": "st-354aa98f**********b-046aaf5ce59c",
      "isExtAD": true,
      "startTime": "2026-09-08T11:35:08.678Z",
      "summaries": [
        {
          "summaryId": "smr-8ca89**********3b6-0c3a26eadc75",
          "participant": {
            "identity": "an-b6685f2**********-72028014d4d2",
            "name": "Anonymous",
            "type": "agent",
            "startTime": [],
            "endTime": []
          },
          "summary": "",
          "type": "final",
          "editedSummary": "Summary",
          "generationTimeInSecs": 0.075,
          "generatedAt": "2026-09-08T11:36:08.977Z"
        },
        {
          "type": "landing",
          "summary": "Unable to fetch the summary",
          "generatedAt": "2026-09-08T11:35:08.818Z"
        }
      ],
      "isLoaded": true,
      "aaSessionId": "6a9**********e94c1d1e",
      "aaUserId": "u-6e98ba**********73a2c469b3cc",
      "experience": "chat",
      "messages": [
        {
          "_id": "6a9f**********bdb9a8",
          "type": "AGENTIC",
          "timestampValue": 178*****17470,
          "requestId": "aa-d84e4504-5b**********253d35041",
          "conversationId": "atest******ljlf",
          "botId": "st-354aa98f-**********aaf5ce59c",
          "accountId": "6a34**********f4bad04a",
          "orgId": "o-f4ba2e4c**********97330540cb59",
          "experience": "chat",
          "language": "en",
          "query": "Trigger welcome event",
          "components": {
            "_id": "cp-843fd8**********-d4aae5c220a9",
            "cT": "text",
            "data": {
              "text": "Subject: Welcome to Our Service"
            }
          },
          "triggeringMessageId": null,
          "isSent": false,
          "isCopied": false,
          "isOverride": false,
          "requestedAt": "2026-09-08T11:35:17.468Z",
          "respondedAt": "2026-09-08T11:35:21.489Z",
          "sessionInfo": {
            "status": "idle",
            "userReference": "atest******ljlf",
            "sessionReference": "atest******ljlf",
            "userId": "u-385a882b-39**********1003d2d37a5",
            "sessionId": "s-fcdc4**********0-8a12-03a3629d1652",
            "runId": "r-bc72dd22-**********8-8acfc8fe2c9b",
            "appId": "aa-5858db2d**********-0eb67be6bd9e",
            "envId": "env-fad4b5e**********09c0ee5d8ef",
            "envName": "Dev",
            "conversationState": "COMPLETED",
            "voiceAgentSwitch": {
              "agentName": null,
              "taskStatus": "COMPLETED"
            },
            "attachments": [],
            "source": "AIS-AA",
            "activeConversationAgent": null
          }
        },
        {
          "_id": "ms-06374fa**********c19d82d0e090",
          "botId": "st-354aa**********6b-046aaf5ce59c",
          "accountId": "6a34e**********7f4bad04a",
          "components": [
            {
              "_id": "cp-90bdfd5**********-01c5102aa07b",
              "cT": "text",
              "data": {
                "text": "could you please write an email regarding leave"
              },
              "thumbnails": []
            }
          ],
          "createdOn": "2026-09-08T11:35:35.366Z",
          "lmodifiedOn": "2026-09-08T11:35:35.366Z",
          "ire": true,
          "chnl": "agentassist",
          "lang": "en",
          "author": {
            "type": "USER"
          },
          "conversationId": "atest******ljlf",
          "__lModifiedOn__": "2026-09-08T11:35:35.000Z",
          "timestampValue": 17**********72
        },
        {
          "_id": "6a9ff30**********6bdba00",
          "type": "AGENTIC",
          "timestampValue": 1788****35671,
          "requestId": "aa-69d649fb-5**********d-120d0e085538",
          "conversationId": "atest******ljlf",
          "botId": "st-354aa98f-ab**********46aaf5ce59c",
          "accountId": "6a34e**********f4bad04a",
          "orgId": "o-f4ba2e4c-**********97330540cb59",
          "experience": "chat",
          "language": "en",
          "query": "could you please write an email regarding leave",
          "components": {
            "_id": "cp-28e8bfc0-43b6**********a6b724a3",
            "cT": "text",
            "data": {
              "text": "Subject: Leave Request"
            }
          },
          "triggeringMessageId": "ms-06374faa**********4b-c19d82d0e090",
          "isSent": false,
          "isCopied": false,
          "isOverride": false,
          "requestedAt": "2026-09-08T11:35:35.669Z",
          "respondedAt": "2026-09-08T11:35:41.920Z",
          "sessionInfo": {
            "status": "idle",
            "userReference": "atest******ljlf",
            "sessionReference": "atest******ljlf",
            "userId": "u-385a882b-**********b-31003d2d37a5",
            "sessionId": "s-fcdc46a9-9431-4480-**********29d1652",
            "runId": "r-2fc7e3c1-f650-4e**********98ac71fb89",
            "appId": "aa-5858db2d-b109**********eb67be6bd9e",
            "envId": "env-fad4b5e**********709c0ee5d8ef",
            "envName": "Dev",
            "conversationState": "COMPLETED",
            "voiceAgentSwitch": {
              "agentName": null,
              "taskStatus": "COMPLETED"
            },
            "attachments": [],
            "source": "AIS-AA",
            "activeConversationAgent": null
          }
        }
      ],
      "searchHistory": [],
      "agenticAssistSessionIds": [
        "s-fcdc46a9-9431-4480-**********29d1652"
      ],
      "agenticSearchSessionIds": [],
      "widgetFeedbacks": []
    }
  ],
  "skip": 0,
  "limit": 20,
  "hasMore": false,
  "totalPages": 1,
  "totalResults": 8
}
```

## Response Body Parameters

| Field | Type | Description |
| - | - | - |
| `_id` | String | Unique identifier of the conversation record. |
| `convId` | String | Unique conversation ID. |
| `botId` | String | Identifier of the bot associated with the conversation. |
| `isExtAD` | Boolean | Indicates whether the conversation is associated with an external Active Directory. |
| `startTime` | String | Date and time when the conversation started in ISO 8601 format. |
| `summaries` | Array | Summary information generated for the conversation. |
| `summaries.summaryId` | String | Unique identifier of the summary. |
| `summaries.participant` | Object | Participant details associated with the summary. |
| `summaries.participant.identity` | String | Unique participant identifier. |
| `summaries.participant.name` | String | Participant name. |
| `summaries.participant.type` | String | Participant type, such as agent or user. |
| `summaries.participant.startTime` | Array | Participant start time information. |
| `summaries.participant.endTime` | Array | Participant end time information. |
| `summaries.summary` | String | Generated summary text. |
| `summaries.editedSummary` | String | Edited version of the generated summary. |
| `summaries.type` | String | Type of summary, such as `final` or `landing`. |
| `summaries.generationTimeInSecs` | Number | Time taken to generate the summary in seconds. |
| `summaries.generatedAt` | String | Date and time when the summary was generated in ISO 8601 format. |
| `isLoaded` | Boolean | Indicates whether the conversation data is fully loaded. |
| `aaSessionId` | String | Agent AI session identifier. |
| `aaUserId` | String | Agent AI user identifier. |
| `experience` | String | Experience type associated with the conversation. |
| `messages` | Array | Messages exchanged during the conversation. |
| `messages._id` | String | Unique message identifier. |
| `messages.type` | String | Message type. |
| `messages.timestampValue` | Number | Message timestamp in milliseconds. |
| `messages.requestId` | String | Unique request identifier. |
| `messages.conversationId` | String | Conversation ID associated with the message. |
| `messages.botId` | String | Bot identifier associated with the message. |
| `messages.accountId` | String | Account identifier. |
| `messages.orgId` | String | Organization identifier. |
| `messages.experience` | String | Experience type. |
| `messages.language` | String | Language of the message. |
| `messages.query` | String | User query processed by the system. |
| `messages.components` | Object | Message content and associated metadata. |
| `messages.triggeringMessageId` | String | Identifier of the message that triggered the response. |
| `messages.isSent` | Boolean | Indicates whether the message was sent. |
| `messages.isCopied` | Boolean | Indicates whether the message was copied. |
| `messages.interacted` | Boolean | Indicates whether the message was interacted with. |
| `messages.artifacts` | Array | Artifacts associated with the message. |
| `messages.isOverride` | Boolean | Indicates whether the response overrides another response. |
| `messages.requestedAt` | String | Date and time when the request was submitted in ISO 8601 format. |
| `messages.respondedAt` | String | Date and time when the response was generated in ISO 8601 format. |
| `messages.agentId` | String | Identifier of the responding agent. |
| `messages.sessionInfo` | Object | Session information associated with the message. |
| `messages.sessionInfo.status` | String | Current session status. |
| `messages.sessionInfo.userReference` | String | User reference associated with the session. |
| `messages.sessionInfo.sessionReference` | String | Session reference associated with the session. |
| `messages.sessionInfo.userId` | String | User identifier. |
| `messages.sessionInfo.sessionId` | String | Session identifier. |
| `messages.sessionInfo.runId` | String | Run identifier. |
| `messages.sessionInfo.appId` | String | Application identifier. |
| `messages.sessionInfo.envId` | String | Environment identifier. |
| `messages.sessionInfo.envName` | String | Environment name. |
| `messages.sessionInfo.conversationState` | String | Current conversation state. |
| `messages.sessionInfo.voiceAgentSwitch` | Object | Voice agent switch information. |
| `messages.sessionInfo.voiceAgentSwitch.agentName` | String | Name of the voice agent. |
| `messages.sessionInfo.voiceAgentSwitch.taskStatus` | String | Status of the voice agent task. |
| `messages.sessionInfo.attachments` | Array | Attachments associated with the session. |
| `messages.sessionInfo.source` | String | Source of the session. |
| `messages.sessionInfo.activeConversationAgent` | String | Currently active conversation agent. |
| `searchHistory` | Array | Search history associated with the conversation. |
| `agenticAssistSessionIds` | Array | List of Agent Assist session IDs. |
| `agenticSearchSessionIds` | Array | List of Agentic Search session IDs. |
| `widgetFeedbacks` | Array | Feedback associated with widgets. |
| `skip` | Integer | Number of records skipped in the response. |
| `limit` | Integer | Maximum number of records returned per page. |
| `hasMore` | Boolean | Indicates whether additional records are available. |
| `totalPages` | Integer | Total number of available pages. |
| `totalResults` | Integer | Total number of matching records. |

## Interactions

| Feature | Description | Expected Tracking |
| - | - | - |
| Link Click Tracking | Track when an agent clicks a document or reference link in an AgentAI or NBA response. | Capture link click events. |
| Accordion / Expandable Section Engagement Tracking | Track when an agent expands a section to view its content. | Capture expand events for each section. |
| Thumbs Up / Thumbs Down per Section | Allow agents to provide feedback on individual expandable sections. | Capture Thumbs Up and Thumbs Down feedback for each section. |
| Section Usage Analytics | Enable administrators to review section-level engagement. | Track the number of section expansions and section-wise usage counts using the artifact section ID. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.