Get a session

POST 
/api/v1/evals/get-session

Fetch one session and the traces belonging to it.

Session summaries

Section ID: DOC-IS-evaluation-api-getSession#session-summaries

Session summaries can include activity outside the list window, and a session can repeat at cursor boundaries. Deduplicate by session ID when collecting pages. Missing rollup data reported as zero is not proof that the session used no resources. Keep those limits with your diagnosis.

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-getSession#example-evals-getSession-request

Request example

{
  "sessionId": "example_123"
}

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

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

Response example

{
  "session": {
    "summary": {
      "sessionId": "example_123",
      "durationSeconds": 1,
      "environment": "example",
      "userIds": [
        "example_123"
      ],
      "traceCount": 1,
      "totalCost": 1,
      "inputTokens": "1",
      "outputTokens": "1",
      "totalTokens": "1",
      "traceTags": [
        "example"
      ],
      "commentCount": 1,
      "metadataJson": "{}",
      "bookmarked": true,
      "conversationIds": [
        "example_123"
      ]
    },
    "traces": [
      {
        "traceId": "example_123",
        "name": "example",
        "inputJson": "{}",
        "outputJson": "{}",
        "latencySeconds": 1,
        "totalCost": 1,
        "environment": "example",
        "tags": [
          "example"
        ],
        "metadataJson": "{}",
        "bookmarked": true,
        "version": "example",
        "release": "example",
        "userId": "example_123",
        "sessionId": "example_123",
        "observationCount": 1,
        "conversationId": "example_123",
        "sourceUserMessageId": "example_123",
        "profileId": "example_123",
        "configHash": "example",
        "inputTokens": "1",
        "outputTokens": "1",
        "totalTokens": "1",
        "errorCount": 1,
        "warningCount": 1,
        "defaultCount": 1,
        "debugCount": 1,
        "commentCount": 1
      }
    ]
  },
  "contentRedacted": true
}

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

Section	Stable reference
Get a session	DOC-IS-evaluation-api-getSession#overview
Request	DOC-IS-evaluation-api-getSession#request
Responses	DOC-IS-evaluation-api-getSession#responses