API for Agentic Conversation History

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

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

{

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

​API Details

​Query Parameters

​Header Parameters

​Sample Request

​Request Path Parameters

​Sample Response

​Response Body Parameters