Skip to main content
Back to 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

FieldValue
MethodGET
Endpointhttps://{{host}}api/v1/public/{{streamId}}/aaconversations/{{conversationId}}/agentic-history
Content Typeapplication/json
Authorizationauth: {{JWT}}: See How to generate the JWT Token
API ScopeAgentAssist Analytics

​
Query Parameters

ParameterTypeRequiredDescription
pagenumberYesPage number for pagination.
limitnumberYesNumber of records per page.
searchbooleanNoEnables search-based filtering when set to true.

​
Header Parameters

HeaderTypeRequiredDescription
authstringYesJWT 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: <JWT_TOKEN>'

​
Request Path Parameters

ParameterTypeRequiredDescription
streamIdstringYesUnique identifier for the stream.
conversationIdstringYesUnique identifier for the conversation session.

​
Sample Response


    "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

ParameterTypeDescription
resultsarrayList of conversation interaction records.
results[].requestIdstringUnique identifier for the request.
results[].conversationIdstringUnique identifier for the conversation session.
results[].botIdstringIdentifier of the Agentic application.
results[].accountIdstringIdentifier of the account associated with the request.
results[].orgIdstringIdentifier of the organization.
results[].querystringUser query submitted in the conversation.
results[].overridebooleanIndicates whether the response overrides default behavior.
results[].isSearchbooleanIndicates whether the query is processed as a search request.
results[].participantIdstringIdentifier of the participant in the conversation.
results[].timestampstring (ISO 8601)Time when the query was received.
results[].languagestringLanguage of the query.
results[].experiencestringInteraction channel (for example, chat or voice).
results[].responsesarrayList of responses generated for the query.
results[].responses[].serviceTypestringType of service that generated the response.
results[].responses[].reqStatusstringRequest status code returned by the service.
results[].responses[].resStatusintegerHTTP status code of the response.
results[].responses[].responsearrayContent elements of the response.
results[].responses[].response[].typestringType of response content (for example, text).
results[].responses[].response[].contentstringResponse content generated by the service.
results[].responses[].sessionInfoobjectMetadata related to the session.
results[].responses[].sessionInfo.statusstringCurrent status of the session.
results[].responses[].sessionInfo.userReferencestringReference identifier for the user.
results[].responses[].sessionInfo.sessionReferencestringReference identifier for the session.
results[].responses[].sessionInfo.userIdstringUnique identifier of the user.
results[].responses[].sessionInfo.sessionIdstringUnique identifier of the session.
results[].responses[].sessionInfo.runIdstringIdentifier of the execution run.
results[].responses[].sessionInfo.appIdstringIdentifier of the application.
results[].responses[].sessionInfo.attachmentsarrayList of attachments associated with the session.
results[].responses[].sessionInfo.conversationStatestringCurrent state of the conversation.
results[].responses[].sessionInfo.activeConversationAgentstringName of the active agent handling the conversation.
results[].responses[].sessionInfo.voiceAgentSwitchobjectDetails about voice agent switching.
results[].responses[].sessionInfo.voiceAgentSwitch.agentNamestringName of the voice agent.
results[].responses[].sessionInfo.voiceAgentSwitch.taskStatusstringCurrent task status of the agent.
results[].responses[].sessionInfo.sourcestringSource of the interaction.
results[].responses[].receivedAtstring (ISO 8601)Time when the response was received.
totalCountintegerTotal number of records available.
pageintegerCurrent page number.
totalPagesintegerTotal number of pages available.
limitintegerMaximum number of records per page.
hasMorebooleanIndicates whether more records are available.