List sessions

POST 
/api/v1/evals/list-sessions

Lists sessions for the authenticated tenant.

The filters array accepts the session columns id (the session id), userIds, traceTags, createdAt, environment and metadata. Columns aggregated over a session — duration, trace count, tokens, scores, comments — cannot be filtered and are rejected with HTTP 400. There is no free-text search.

Reads are bounded. A session can repeat at an equal-timestamp cursor boundary. Summary activity can extend outside the list window; unavailable rollup data can appear as zero. Do not treat these summaries as a complete frozen cohort.

The following access conditions are preserved as declared intent and are not implemented by generated code: Authorized scoped domain action.

Use this in a guide: Find out why a customer’s reply was slow

Request

Responses

200

OK

Schema-valid request illustration; replace example identifiers and confirm operation prerequisites.

Section ID: DOC-IS-evaluation-api-listSessions#example-evals-listSessions-request

Request example

{}

Illustrative response shape; omitted default fields and actual outcomes depend on the operation.

Section ID: DOC-IS-evaluation-api-listSessions#example-evals-listSessions-response

Response example

{
  "sessions": [
    {
      "sessionId": "example_123",
      "createdAt": "2026-09-16T12:00:00Z",
      "durationSeconds": 1,
      "environment": "example",
      "userIds": [
        "example_123"
      ],
      "traceCount": 1,
      "totalCost": 1,
      "inputTokens": "1",
      "outputTokens": "1",
      "totalTokens": "1",
      "traceTags": [
        "example"
      ],
      "scores": [
        {
          "scoreId": "example_123",
          "targetType": "EVAL_TARGET_TYPE_TRACE",
          "targetId": "example_123",
          "name": "example",
          "dataType": "SCORE_DATA_TYPE_NUMERIC",
          "numericValue": 1,
          "stringValue": "example",
          "booleanValue": true,
          "source": "SCORE_SOURCE_JUDGE",
          "comment": "example",
          "textValue": "Example text",
          "authorUserId": "example_123",
          "configId": "example_123",
          "queueId": "example_123",
          "traceId": "example_123",
          "observationId": "example_123",
          "sessionId": "example_123",
          "datasetRunId": "example_123",
          "environment": "example",
          "metadataJson": "{}",
          "traceName": "example",
          "userId": "example_123",
          "sourceLabel": "example",
          "conversationId": "example_123",
          "messageId": "example_123",
          "messageSequence": "1",
          "profileId": "example_123",
          "configHash": "example"
        }
      ],
      "commentCount": 1,
      "metadataJson": "{}",
      "bookmarked": true,
      "conversationIds": [
        "example_123"
      ]
    }
  ],
  "cursorPage": {
    "nextCursor": "example",
    "limit": 1,
    "totalItems": 1
  }
}

Document ID: DOC-IS-evaluation-api-listSessions. Section identities and revisions.

Section	Stable reference
List sessions	DOC-IS-evaluation-api-listSessions#overview
Request	DOC-IS-evaluation-api-listSessions#request
Responses	DOC-IS-evaluation-api-listSessions#responses