---
title: "Retrieve an insight"
method: GET
path: "/insights/v1/results/source/{sourceID}/insight/{insightKey}"
tags: ["Insights"]
---

# Retrieve an insight

`GET /insights/v1/results/source/{sourceID}/insight/{insightKey}`

Returns the metadata and aggregate summary for a single insight identified by source and key.
Does not include individual resource-level results — use the resource-results endpoint for those.

## Path parameters

- `sourceID` string, required
- `insightKey` string, required

## Response `200`

Successful operation

- InsightResponse — An insight result containing summary information and metadata.
  - `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.

## 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)