---
title: "Get Experiment Insights"
method: GET
path: "/experimental/projects/{project_id}/experiments/{experiment_id}/insights"
tags: ["logstream-insights"]
---

# Get Experiment Insights

`GET /experimental/projects/{project_id}/experiments/{experiment_id}/insights`

Get insights for a specific experiment.

## Path parameters

- `experiment_id` string, uuid4, required
- `project_id` string, uuid4, required

## Response `200`

Successful Response

- LogstreamInsightsResponse
  - `insights` union, required
    - InsightDBV2[]
      - `id` string, uuid4
      - `created_at` string, date-time
      - `updated_at` string, date-time
      - `insight` InsightV2, required
        - `title` string, required — Short generated name for the signal.
        - `observation` string, required — Concise generated description of the recurring behavior.
        - `details` string, required — Generated analysis explaining the behavior, impact, and supporting pattern.
        - `suggested_action` string, required — Generated remediation recommended for the signal.
        - `all_occurrences` InsightOccurrenceV2[], required — Occurrences sampled during signal generation.
          - `session_id` string, required — Session containing this retained signal occurrence.
          - `spans_involved` SpanInvolved[], required — Spans sampled for this occurrence.
            - `trace_id` string, required — Trace containing the retained evidence span.
            - `span_id` string, required — Span retained as evidence for the signal.
          - `session_created_at` string, date-time, nullable — Creation time of the session.
        - `example_occurrences` InsightExampleOccurrenceV2[], required — Representative occurrences selected to explain the signal.
          - `session_id` string, required — Session used for this representative example.
          - `example_narrative` string, required — Generated explanation of the representative example.
          - `span_links` SpanLinkV2[], required — Spans that support this representative example.
            - `trace_id` string, required — Trace containing the example span.
            - `span_id` string, required — Span referenced by the example narrative.
            - `span_sub_narrative` string, required — Explanation of how this span supports the example.
        - `priority` integer, required — Priority from 1 to 10. Higher values indicate more severe issues.
        - `priority_category` 'error' | 'warning' | 'info', nullable — Priority category: error, warning, or info.
        - `label` 'Instruction' | 'Retrieval' | 'Decision' | 'Output' | 'Tool' | 'Reliability' | 'Security' | 'Efficiency', nullable — Primary category for the signal. Null only for legacy signals.
        - `input_data_latest_updated_ts` string, date-time, nullable — Latest input timestamp processed during signal generation.
    - InsightDB[]
      - `id` string, uuid4
      - `created_at` string, date-time
      - `updated_at` string, date-time
      - `insight` Insight, required
        - `title` string, required
        - `observation` string, required
        - `details` string, required
        - `suggested_action` string, required
        - `all_occurrences` InsightOccurrence[], required
          - `trace_id` string, required
          - `span_ids` string[], required
        - `example_occurrences` InsightExampleOccurrence[], required
          - `trace_id` string, required
          - `example_narrative` string, required
          - `span_links` SpanLink[], required
            - `span_id` string, required
            - `span_sub_narrative` string, required
        - `priority` integer, required
        - `priority_category` 'error' | 'warning' | 'info', nullable
        - `label` 'Instruction' | 'Retrieval' | 'Decision' | 'Output' | 'Tool' | 'Reliability' | 'Security' | 'Efficiency', nullable
        - `input_data_latest_updated_ts` string, date-time, nullable
  - `job_status` 'unstarted' | 'in_progress' | 'processed' | 'completed' | 'error' | 'failed', required
  - `is_update_job` boolean, required
  - `job_updated_at` string, date-time, nullable, required
  - `job_run_summary` object, nullable

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-02** `4bc031507246` — 2 info
  - added `subschema #1, subschema #2` to the `insights` response property `anyOf` list for the response status `200`
  - removed `subschema #1, subschema #2` from the `insights` response property `anyOf` list for the response status `200`
- **2026-07-26** `05003e7835a2` — 1 info
  - the endpoint scheme security `ClassicAPIKeyHeader` was added to the API

[Change history](https://skmtc.dev/galileo/apis/galileo-api-server/changes/experimental/projects/:project_id/experiments/:experiment_id/insights/get.md)

---

[API](https://skmtc.dev/galileo/apis/galileo-api-server.md) · [All operations](https://skmtc.dev/galileo/apis/galileo-api-server/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/galileo/galileo-api-server/revisions/4bc031507246/schema)