---
title: "Get Insights by Account"
method: POST
path: "/governance/insights"
tags: ["Governance"]
---

# Get Insights by Account

`POST /governance/insights`

Retrieves insights for a specific account with optional filtering and field projection

## Query parameters

- `fields` string

## Request body

- object
  - `query` string — Search query string
  - `labels` union — Labels for filtering insights
    - string — Comma-separated labels
    - string[] — Array of labels
  - `frameworks` string[] — Array of framework filters
  - `category` string — Category filter
  - `isDefault` boolean, nullable — Default filter flag
  - `onlySubscribed` boolean — Filter for subscribed insights only
  - `onlyProduction` boolean — Filter for production insights only
  - `onlyMatchingAssets` boolean — Filter for insights with matching assets
  - `onlyEnabled` boolean — Filter for enabled insights only
  - `onlyAvailableProviders` boolean — Filter for available providers only
  - `showExclusion` boolean — Show exclusion rules
  - `type` string[] — Array of type filters
  - `providers` string[] — Array of provider filters
  - `integrations` string[] — Array of integration filters
  - `severity` union[] — Array of severity filters
    - union
      - string
      - integer
  - `id` union — Array of specific insight ID filters or null
    - string[] — Array of specific insight ID filters
    - string, nullable — No ID filter applied
  - `page` integer — Page number for pagination
  - `page_size` integer — Number of items per page
  - `sorting` object[] — Array of sorting criteria
    - `field` string
    - `sort` 'asc' | 'desc'
  - `providersAccounts` string[] — Array of provider account filters

## Response `200`

Insights retrieved successfully

- object
  - `data` object[]
  - `total` integer — Total number of insights
  - `page` integer — Current page number
  - `page_size` integer — Number of items per page

## Other responses

- `400` — Bad request - missing required parameters
- `401` — Unauthorized
- `500` — Internal server error

---

[API](https://skmtc.net/firefly/apis/api-gateway.md) · [All operations](https://skmtc.net/firefly/apis/api-gateway/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/firefly/api-gateway/revisions/eea119b4113f/schema)