API for Duration-Based Conversation Records

Back to 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
Scope	`AgentAssist Analytics`: See Associate 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

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

{
    "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.

​API Details

​Path Parameters

​Header Parameters

​Body Parameters

​Sample Request

​Sample Response

​Response Body Parameters

API Details

Path Parameters

Header Parameters

Body Parameters

Sample Request

Sample Response

Response Body Parameters