---
title: "List insights"
method: GET
path: "/insights/v1/results"
tags: ["Insights"]
---

# List insights

`GET /insights/v1/results`

Returns a paginated list of insights with their aggregate summaries (savings, risk counts).
Use query parameters to filter by status, category, provider, or priority.
Does not include individual resource-level results — use the resource-results endpoint for those.

## Query parameters

- `searchTerm` string
- `displayStatus` string[]
- `category` 'FinOps' | 'OperationalExcellence' | 'PerformanceEfficiency' | 'Reliability' | 'Security' | 'Sustainability'
- `cloudProvider` string — The cloud provider associated with the resource.
- `source` Source[]
- `priority` string[]
- `tag` string[]
- `easyWin` boolean
- `cloudFlows` boolean
- `pageToken` string
- `maxResults` integer

## Response `200`

Successful operation

- ResultsBody — Paginated list of insight results.
  - `results` InsightResponse[] — List of insight results.
    - `source` string — The source that generated the insight.
    - `key` string — The unique key identifying this insight.
    - `title` string — The display title of the insight.
    - `shortDescription` string — A brief summary of the insight.
    - `detailedDescriptionMdx` string — A detailed description of the insight in MDX format.
    - `displayStatus` 'actionable' | 'acknowledged' | 'optimized' | 'dismissed' | 'in progress' | 'upgrade needed' | 'permissions needed' — The display status of the insight.
    - `cloudProvider` string — The cloud provider associated with the resource.
    - `categories` Category[] — Categories this insight belongs to.
    - `summary` InsightSummary — Aggregate summary of risks and savings across all resource results for an insight.
      - `operationalRisks` number, double — Total number of operational risks.
      - `performanceRisks` number, double — Total number of performance risks.
      - `potentialDailySavings` number, double — Total potential daily savings in USD.
      - `reliabilityRisks` number, double — Total number of reliability risks.
      - `securityRisks` number, double — Total number of security risks.
      - `sustainabilityRisks` number, double — Total number of sustainability risks.
    - `lastStatusChange` LastInsightStatusChange — If set, this object contains the last status change made by a user for this insight
      - `userId` string, required — the reference to the user who made the change (if it was made by a user) If the change was made by an automated system, this reference is empty.
      - `lastChangedAt` string, date-time, required
    - `lastUpdated` string, date-time — Timestamp of the last update to this insight.
    - `tags` string[] — Tags for the insight, primarily used for security certification labels (e.g. ISO).
    - `reportUrl` string — URL to an external report related to this insight.
    - `cloudFlowTemplateId` string — ID of a CloudFlow template that can automate the remediation of this insight.
    - `easyWinDescription` string — A description of why this insight is considered an easy win.
    - `dismissalDetails` DismissalDetails — Details for why an insight was dismissed.
      - `reason` 'not relevant' | 'not enough information' | 'not worth the effort' | 'inaccurate optimization opportunities' — The reason for dismissal.
      - `comment` string — An optional free-text comment providing additional context.
  - `pagination` Pagination — Cursor-based pagination metadata.
    - `pageToken` string — Token to retrieve the next page. Absent when there are no more pages.
    - `rowCount` integer, required — Number of items in this page.

## Other responses

- `400` — Bad Request - The server cannot process the request, often due to a malformed request.
- `401` — Unauthorized - Invalid API key.
- `403` — Forbidden - The client is not authorized to perform the request.
- `404` — Not Found - The requested resource does not exist.
- `500` — Internal Server Error - Something went wrong with the DoiT API server.

---

[API](https://skmtc.dev/doit/apis/doit-cloud-intelligence.md) · [All operations](https://skmtc.dev/doit/apis/doit-cloud-intelligence/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/doit/doit-cloud-intelligence/revisions/9416402fc119/schema)