> ## 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 Agentic Conversation History

[Back to API List](https://koreai.mintlify.site/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](https://koreai.mintlify.site/ai-for-service/apis/automation/api-introduction.md#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

```bash theme={null}
curl --location --max-time 15 'https://{{host}}/agentassist/api/v1/public/{{streamId}}/aaconversations/{{conversationId}}/agentic-history?page=1&limit=10&search=true' \

--header 'auth: <JWT_TOKEN>'
```

## 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

```json expandable=true 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. |


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