---
title: "Get Insights"
method: GET
path: "/api/v1/ollie/projects/{project_id}/insights"
tags: ["ollie"]
---

# Get Insights

`GET /api/v1/ollie/projects/{project_id}/insights`

Return deterministic Ollie insight candidates for the current scope.

## Path parameters

- `project_id` string, uuid, required

## Query parameters

- `part_id` string, uuid, nullable — Optional part scope.
- `feature_id` string, nullable — Optional selected feature scope.
- `limit` integer

## Response `200`

Successful Response

- OllieInsightsResponse — Read model for scoped Ollie insight candidates.
  - `scope` 'project' | 'part' | 'feature', required
  - `project_id` string, uuid, required
  - `part_id` string, uuid, nullable
  - `feature_id` string, nullable
  - `count` integer, required
  - `candidates` OllieInsightCandidate[], required
    - `id` string, required
    - `scope` 'project' | 'part' | 'feature', required
    - `severity` 'blocker' | 'review' | 'suggestion' | 'info', required
    - `category` 'quote_readiness' | 'dfm' | 'drawing' | 'feature_uncertainty' | 'pricing' | 'lead_time' | 'intent', required
    - `title` string, required
    - `prompt` string, required
    - `rationale` string, required
    - `confidence` 'high' | 'medium' | 'low', required
    - `requires_confirmation` boolean, required
    - `part_id` string, nullable
    - `part_name` string, nullable
    - `feature_id` string, nullable
    - `downstream_impacts` string[], required
    - `evidence` OllieInsightEvidence[], required
      - `source` string, required
      - `kind` string, required

## Other responses

- `422` — Validation Error

---

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