List observations

POST 
/api/v1/evals/list-observations

Lists the individual spans, generations and events inside traces.

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

Request example

{}

Guide request for Check whether the same tool keeps failing. Replace example resource identifiers with your own authorized values.

Section ID: DOC-IS-evaluation-api-listObservations#example-cookbook-insights-evaluation-reading-04-request

Request example

{
  "filters": [
    {
      "column": "level",
      "operator": "=",
      "type": "EVAL_FILTER_TYPE_STRING",
      "stringValue": "ERROR"
    }
  ],
  "pageSize": 50
}

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

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

Response example

{
  "observations": [
    {
      "observationId": "example_123",
      "traceId": "example_123",
      "parentObservationId": "example_123",
      "type": "OBSERVATION_TYPE_SPAN",
      "name": "example",
      "level": "OBSERVATION_LEVEL_DEBUG",
      "statusMessage": "example",
      "startTime": "2026-09-16T12:00:00Z",
      "endTime": "2026-09-16T12:00:00Z",
      "completionStartTime": "2026-09-16T12:00:00Z",
      "latencySeconds": 1,
      "inputJson": "{}",
      "outputJson": "{}",
      "metadataJson": "{}",
      "model": "example",
      "modelParametersJson": "{}",
      "inputTokens": "1",
      "outputTokens": "1",
      "totalTokens": "1",
      "inputCost": 1,
      "outputCost": 1,
      "totalCost": 1,
      "environment": "example",
      "version": "example",
      "promptName": "Example text",
      "promptVersion": 1,
      "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,
      "conversationId": "example_123",
      "sourceUserMessageId": "example_123",
      "profileId": "example_123",
      "configHash": "example"
    }
  ],
  "contentRedacted": true,
  "cursorPage": {
    "nextCursor": "example",
    "limit": 1,
    "totalItems": 1
  }
}

Illustrative response for Check whether the same tool keeps failing. Replace example resource identifiers with your own authorized values.

Section ID: DOC-IS-evaluation-api-listObservations#example-cookbook-insights-evaluation-reading-json-02-response

Response example

{
  "observations": [
    {
      "observationId": "obs_9",
      "traceId": "trc_a1b2c3",
      "parentObservationId": "obs_2",
      "name": "get_weather",
      "level": "OBSERVATION_LEVEL_ERROR",
      "statusMessage": "upstream timeout",
      "latencySeconds": 30
    }
  ],
  "cursorPage": {
    "limit": 50
  },
  "contentRedacted": true
}

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

Section	Stable reference
List observations	DOC-IS-evaluation-api-listObservations#overview
Request	DOC-IS-evaluation-api-listObservations#request
Responses	DOC-IS-evaluation-api-listObservations#responses