Dec 2025 - New! Caching input tokens unlocks immediate, automatic ~30% credit savings on supported models
curl --request POST \
--url http://localhost:3000/api/admin/histories \
--header 'Content-Type: application/json' \
--header 'x-access-token: <api-key>' \
--data '
{
"institution": "<string>",
"usersearch": "<string>",
"limitsearch": 123
}
'{
"success": true,
"data": [
{
"_id": "<string>",
"credits": 123,
"usage": 123,
"cached": 123,
"completion": 123,
"latencyMs": 123,
"input": "<string>",
"inputs": [
"<string>"
],
"output": "<string>",
"outputs": [
"<string>"
],
"success": true,
"user": {
"_id": "<string>",
"email": "[email protected]",
"fname": "<string>",
"lname": "<string>",
"accountType": "<string>",
"lxp_user_id": 123,
"picture": "<string>",
"status": "<string>",
"lxp_user_type": 123,
"lxp_partner_id": 123,
"lxp_partner_name": "<string>",
"lxp_role_id": 123,
"lxp_role_name": "<string>",
"credits": 123,
"creditsUsed": 123,
"plan": "<string>",
"institution": {
"_id": "<string>",
"name": "<string>",
"picture": "<string>",
"credits": 123,
"creditsUsed": 123,
"creditsAwarded": 123,
"status": "active",
"publicId": "<string>",
"publicAuthorizedUrls": [
"<string>"
],
"ainame": "<string>",
"contactEmail": "<string>",
"poolCredits": true,
"created": "2023-11-07T05:31:56Z",
"conversationModel": "<string>",
"account": {
"_id": "<string>",
"name": "<string>"
},
"maxCompletionTokens": 123,
"creditsTotal": 123,
"creditsUsagePct": 123,
"id": "<string>",
"displayAgentDetails": true
},
"remember_history_count": 123,
"created": "2023-11-07T05:31:56Z"
},
"institution": {
"_id": "<string>",
"name": "<string>",
"picture": "<string>",
"credits": 123,
"creditsUsed": 123,
"creditsAwarded": 123,
"status": "active",
"publicId": "<string>",
"publicAuthorizedUrls": [
"<string>"
],
"ainame": "<string>",
"contactEmail": "<string>",
"poolCredits": true,
"created": "2023-11-07T05:31:56Z",
"conversationModel": "<string>",
"account": {
"_id": "<string>",
"name": "<string>"
},
"maxCompletionTokens": 123,
"creditsTotal": 123,
"creditsUsagePct": 123,
"id": "<string>",
"displayAgentDetails": true
},
"status": "<string>",
"query_duration_ms": 123,
"course_id": 123,
"course_name": "<string>",
"assistant": "<string>",
"conversation_model": "<string>",
"tools": [
{
"id": "<string>",
"name": "<string>",
"responseLength": 123,
"responseDurationMs": 123,
"success": true,
"_id": "<string>"
}
],
"created": "2023-11-07T05:31:56Z",
"__v": 123
}
]
}Fetches conversation history data filtered by institution, user search term, and result limit
curl --request POST \
--url http://localhost:3000/api/admin/histories \
--header 'Content-Type: application/json' \
--header 'x-access-token: <api-key>' \
--data '
{
"institution": "<string>",
"usersearch": "<string>",
"limitsearch": 123
}
'{
"success": true,
"data": [
{
"_id": "<string>",
"credits": 123,
"usage": 123,
"cached": 123,
"completion": 123,
"latencyMs": 123,
"input": "<string>",
"inputs": [
"<string>"
],
"output": "<string>",
"outputs": [
"<string>"
],
"success": true,
"user": {
"_id": "<string>",
"email": "[email protected]",
"fname": "<string>",
"lname": "<string>",
"accountType": "<string>",
"lxp_user_id": 123,
"picture": "<string>",
"status": "<string>",
"lxp_user_type": 123,
"lxp_partner_id": 123,
"lxp_partner_name": "<string>",
"lxp_role_id": 123,
"lxp_role_name": "<string>",
"credits": 123,
"creditsUsed": 123,
"plan": "<string>",
"institution": {
"_id": "<string>",
"name": "<string>",
"picture": "<string>",
"credits": 123,
"creditsUsed": 123,
"creditsAwarded": 123,
"status": "active",
"publicId": "<string>",
"publicAuthorizedUrls": [
"<string>"
],
"ainame": "<string>",
"contactEmail": "<string>",
"poolCredits": true,
"created": "2023-11-07T05:31:56Z",
"conversationModel": "<string>",
"account": {
"_id": "<string>",
"name": "<string>"
},
"maxCompletionTokens": 123,
"creditsTotal": 123,
"creditsUsagePct": 123,
"id": "<string>",
"displayAgentDetails": true
},
"remember_history_count": 123,
"created": "2023-11-07T05:31:56Z"
},
"institution": {
"_id": "<string>",
"name": "<string>",
"picture": "<string>",
"credits": 123,
"creditsUsed": 123,
"creditsAwarded": 123,
"status": "active",
"publicId": "<string>",
"publicAuthorizedUrls": [
"<string>"
],
"ainame": "<string>",
"contactEmail": "<string>",
"poolCredits": true,
"created": "2023-11-07T05:31:56Z",
"conversationModel": "<string>",
"account": {
"_id": "<string>",
"name": "<string>"
},
"maxCompletionTokens": 123,
"creditsTotal": 123,
"creditsUsagePct": 123,
"id": "<string>",
"displayAgentDetails": true
},
"status": "<string>",
"query_duration_ms": 123,
"course_id": 123,
"course_name": "<string>",
"assistant": "<string>",
"conversation_model": "<string>",
"tools": [
{
"id": "<string>",
"name": "<string>",
"responseLength": 123,
"responseDurationMs": 123,
"success": true,
"_id": "<string>"
}
],
"created": "2023-11-07T05:31:56Z",
"__v": 123
}
]
}JWT token passed in x-access-token header
Successfully retrieved conversation histories
Show child attributes
Show child attributes
User ID
User email address
User first name
User last name
User account type
LXP user identifier
Profile picture URL
User status
LXP user type
LXP partner identifier
LXP partner name
LXP role identifier
LXP role name
Available credits
Credits used
Subscription plan
Show child attributes
Institution ID
Institution name
Institution picture URL
Available credits for the institution
Number of credits used
Credits awarded to the institution
Institution status
active, inactive Public identifier for the institution
List of authorized URLs for the institution
AI name for the institution
Contact email for the institution
Whether credits are pooled
Institution creation timestamp
AI conversation model used
Maximum completion tokens allowed
Total credits available
Percentage of credits used
Institution identifier
Whether to display agent details
History count setting
Creation timestamp
Show child attributes
Institution ID
Institution name
Institution picture URL
Available credits for the institution
Number of credits used
Credits awarded to the institution
Institution status
active, inactive Public identifier for the institution
List of authorized URLs for the institution
AI name for the institution
Contact email for the institution
Whether credits are pooled
Institution creation timestamp
AI conversation model used
Maximum completion tokens allowed
Total credits available
Percentage of credits used
Institution identifier
Whether to display agent details
Was this page helpful?