> ## Documentation Index
> Fetch the complete documentation index at: https://koreai.mintlify.app/llms.txt
> Use this file to discover all available pages before exploring further.
# API for Agentic Conversation History
[Back to API List](/ai-for-service/apis/agent-ai/api-list)
Retrieve user–Agentic app conversation history for a specific session, including user queries and corresponding service responses. Use this API to access paginated interaction history with optional search support.
## API Details
| Field | Value |
| ------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| Method | `GET` |
| Endpoint | `https://{{host}}api/v1/public/{{streamId}}/aaconversations/{{conversationId}}/agentic-history` |
| 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) |
| API Scope | AgentAssist Analytics |
## Query Parameters
| Parameter | Type | Required | Description |
| --------- | ------- | -------- | -------------------------------------------------- |
| `page` | number | Yes | Page number for pagination. |
| `limit` | number | Yes | Number of records per page. |
| `search` | boolean | No | Enables search-based filtering when set to `true`. |
## Header Parameters
| Header | Type | Required | Description |
| ------ | ------ | -------- | ---------------------------------- |
| `auth` | string | Yes | JWT token used for authentication. |
## Sample Request
```
curl --location --max-time 15 'https://{{host}}/agentassist/api/v1/public/{{streamId}}/aaconversations/{{conversationId}}/agentic-history?page=1&limit=10&search=true' \
--header 'auth: '
```
## Request Path Parameters
| Parameter | Type | Required | Description |
| -------------- | ------ | -------- | ----------------------------------------------- |
| streamId | string | Yes | Unique identifier for the stream. |
| conversationId | string | Yes | Unique identifier for the conversation session. |
## Sample Response
```{ theme={null}
"results": [
{
"requestId": "ua-cf500cc3-a13c-40c5-9354-472xxxxxxx2c",
"conversationId": "CH359c95c86f7a4789b32dfxxxxxxxfabd",
"botId": "st-14bff9c5-b5f4-5c2d-a8e0-6xxxxxxx2941",
"accountId": "67a47cbxxxxxxx3b3dae218b",
"orgId": "o-b6bfa238-2275-594e-ae55-317cxxxxxxxc",
"query": "In search of bank loan for home",
"override": false,
"isSearch": true,
"participantId": "an-0e88ee4d-3eb8-4434-886d-fxxxxxxxc4be",
"timestamp": "2026-04-11T07:59:56.745Z",
"language": "en",
"experience": "chat",
"responses": [
{
"serviceType": "agentic",
"reqStatus": "200",
"resStatus": 200,
"response": [
{
"type": "text",
"content": "You’re in the right place—our bank does offer home loans. I can help you understand your options and the next steps.\\n\\nTo guide you properly, I need a few details:\\n\\n1) Are you planning to:\\n • Buy a new/ready-to-move home\\n • Buy an under-construction property\\n • Purchase a plot and construct later\\n • Take over (transfer) an existing home loan from another bank?\\n\\n2) What is your approximate monthly income and employment type?\\n • Salaried (private/government)\\n • Self-employed/business\\n\\n3) In which city and state is the property located or planned?\\n\\nOnce you share these details, I can explain approximate eligibility, tenure, and documents you’ll need, and guide you on how to apply (online or at a branch)."
}
],
"sessionInfo": {
"status": "idle",
"userReference": "st-14bff9c5-b5f4-5c2d-a8e0-6294xxxxxxx1+ch359c95c86fxxxxxxx32df50da67ffabd",
"sessionReference": "st-14bff9c5-b5f4-5c2d-a8e0-62xxxxxxx941+CH359c95c86f7axxxxxxxdf50da67ffabd",
"userId": "u-597b7353-2444-5730-a22e-b2xxxxxxx315",
"sessionId": "s-ae3bbc8b-1a9d-4f79-ad00-2dxxxxxxx411",
"runId": "r-8f6f9b26-0da8-4381-885c-af5xxxxxxx7e",
"appId": "aa-71ef3408-78d4-4280-9a75-72xxxxxxx767",
"attachments": [],
"conversationState": "AWAITING_INPUT",
"activeConversationAgent": "UserQueryResolver",
"voiceAgentSwitch": {
"agentName": "UserQueryResolver",
"taskStatus": "AWAITING_INPUT"
},
"source": "AIS-AA"
},
"receivedAt": "2026-04-11T07:59:59.791Z"
}
]
}
],
"totalCount": 1,
"page": 1,
"totalPages": 1,
"limit": 10,
"hasMore": false
}
```
## Response Body Parameters
| Parameter | Type | Description |
| --------------------------------------------------------------- | ----------------- | ------------------------------------------------------------- |
| `results` | array | List of conversation interaction records. |
| `results[].requestId` | string | Unique identifier for the request. |
| `results[].conversationId` | string | Unique identifier for the conversation session. |
| `results[].botId` | string | Identifier of the Agentic application. |
| `results[].accountId` | string | Identifier of the account associated with the request. |
| `results[].orgId` | string | Identifier of the organization. |
| `results[].query` | string | User query submitted in the conversation. |
| `results[].override` | boolean | Indicates whether the response overrides default behavior. |
| `results[].isSearch` | boolean | Indicates whether the query is processed as a search request. |
| `results[].participantId` | string | Identifier of the participant in the conversation. |
| `results[].timestamp` | string (ISO 8601) | Time when the query was received. |
| `results[].language` | string | Language of the query. |
| `results[].experience` | string | Interaction channel (for example, chat or voice). |
| `results[].responses` | array | List of responses generated for the query. |
| `results[].responses[].serviceType` | string | Type of service that generated the response. |
| `results[].responses[].reqStatus` | string | Request status code returned by the service. |
| `results[].responses[].resStatus` | integer | HTTP status code of the response. |
| `results[].responses[].response` | array | Content elements of the response. |
| `results[].responses[].response[].type` | string | Type of response content (for example, text). |
| `results[].responses[].response[].content` | string | Response content generated by the service. |
| `results[].responses[].sessionInfo` | object | Metadata related to the session. |
| `results[].responses[].sessionInfo.status` | string | Current status of the session. |
| `results[].responses[].sessionInfo.userReference` | string | Reference identifier for the user. |
| `results[].responses[].sessionInfo.sessionReference` | string | Reference identifier for the session. |
| `results[].responses[].sessionInfo.userId` | string | Unique identifier of the user. |
| `results[].responses[].sessionInfo.sessionId` | string | Unique identifier of the session. |
| `results[].responses[].sessionInfo.runId` | string | Identifier of the execution run. |
| `results[].responses[].sessionInfo.appId` | string | Identifier of the application. |
| `results[].responses[].sessionInfo.attachments` | array | List of attachments associated with the session. |
| `results[].responses[].sessionInfo.conversationState` | string | Current state of the conversation. |
| `results[].responses[].sessionInfo.activeConversationAgent` | string | Name of the active agent handling the conversation. |
| `results[].responses[].sessionInfo.voiceAgentSwitch` | object | Details about voice agent switching. |
| `results[].responses[].sessionInfo.voiceAgentSwitch.agentName` | string | Name of the voice agent. |
| `results[].responses[].sessionInfo.voiceAgentSwitch.taskStatus` | string | Current task status of the agent. |
| `results[].responses[].sessionInfo.source` | string | Source of the interaction. |
| `results[].responses[].receivedAt` | string (ISO 8601) | Time when the response was received. |
| `totalCount` | integer | Total number of records available. |
| `page` | integer | Current page number. |
| `totalPages` | integer | Total number of pages available. |
| `limit` | integer | Maximum number of records per page. |
| `hasMore` | boolean | Indicates whether more records are available. |