Skip to main content
POST
/
api
/
admin
/
histories
Retrieve conversation histories for admin users
curl --request POST \
  --url https://pria.praxislxp.com/api/admin/histories \
  --header 'Content-Type: application/json' \
  --header 'x-access-token: <api-key>' \
  --data '
{
  "institution": "<string>",
  "usersearch": "<string>",
  "account": "<string>",
  "accountType": "user",
  "course_name": "<string>",
  "daterange": [
    "2026-01-01",
    "2026-01-31"
  ],
  "page": 1,
  "pageSize": 1000,
  "limit": 123,
  "limitsearch": 123,
  "summary": true,
  "summaryInstruction": "<string>"
}
'
{
  "success": true,
  "data": [
    {
      "_id": "<string>",
      "credits": 123,
      "usage": 123,
      "cached": 123,
      "completion": 123,
      "latencyMs": 123,
      "ragDurationMs": 123,
      "input": "<string>",
      "inputs": [
        "<string>"
      ],
      "output": "<string>",
      "outputs": [
        "<string>"
      ],
      "success": true,
      "user": {
        "_id": "<string>",
        "email": "jsmith@example.com",
        "fname": "<string>",
        "lname": "<string>",
        "accountType": "<string>",
        "status": "<string>",
        "lxp_user_id": "<string>",
        "picture": "<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",
          "lastActivityAt": "2023-11-07T05:31:56Z",
          "conversationModel": "<string>",
          "account": {
            "_id": "<string>",
            "name": "<string>",
            "description": "<string>",
            "status": "active",
            "credits": 123,
            "created": "2023-11-07T05:31:56Z"
          },
          "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",
        "lastActivityAt": "2023-11-07T05:31:56Z",
        "conversationModel": "<string>",
        "account": {
          "_id": "<string>",
          "name": "<string>",
          "description": "<string>",
          "status": "active",
          "credits": 123,
          "created": "2023-11-07T05:31:56Z"
        },
        "maxCompletionTokens": 123,
        "creditsTotal": 123,
        "creditsUsagePct": 123,
        "id": "<string>",
        "displayAgentDetails": true
      },
      "status": "<string>",
      "query_duration_ms": 123,
      "course_id": 123,
      "course_name": "<string>",
      "assistant": {
        "_id": "<string>",
        "name": "<string>"
      },
      "conversation_model": "<string>",
      "tools": [
        {
          "id": "<string>",
          "name": "<string>",
          "responseLength": 123,
          "responseDurationMs": 123,
          "success": true,
          "_id": "<string>",
          "description": "<string>",
          "type": "<string>",
          "schema": {},
          "endpoint": "<string>",
          "status": "active",
          "institution": "<string>",
          "created": "2023-11-07T05:31:56Z"
        }
      ],
      "created": "2023-11-07T05:31:56Z"
    }
  ],
  "total": 123,
  "hasMore": true,
  "page": 123,
  "pageSize": 123,
  "message": "<string>"
}

Authorizations

​
x-access-token
string
header
required

JWT token passed in x-access-token header

Body

application/json
​
institution
string

Institution ID to filter histories (space-separated for multiple)

​
usersearch
string

Search term to filter by user email, first name, or last name

​
account
string

Account ID to filter by account's institutions (space-separated for multiple)

​
accountType
enum<string>

Filter by user account type

Available options:
user,
admin,
super
​
course_name
string

Filter by course name (case-insensitive partial match)

​
daterange
(string<date> | null)[]

Date range filter as [startDate, endDate]. Defaults to last 30 days if not provided. Use null for open-ended ranges.

Required array length: 2 elements
Example:
["2026-01-01", "2026-01-31"]
​
page
integer
default:1

Page number for pagination (1-based)

Required range: x >= 1
​
pageSize
integer
default:1000

Number of records per page (max 5000). Default 1000 for backward compatibility.

Required range: 1 <= x <= 5000
​
limit
integer
deprecated

Deprecated: use 'pageSize' instead.

​
limitsearch
integer
deprecated

Deprecated: use 'pageSize' instead.

​
summary
boolean

When true, returns an AI-generated summary instead of raw data

​
summaryInstruction
string

Custom instruction for the AI summary generation

Response

Successfully retrieved conversation histories

​
success
boolean
​
data
object[]
​
total
integer

Total number of matching records across all pages

​
hasMore
boolean

Whether more pages exist beyond the current page

​
page
integer

Current page number (1-based)

​
pageSize
integer

Records per page (resolved/clamped value)

​
message
string