---
title: "Get Insights for a dataset identifier"
method: GET
path: "/v2/library/data/{dataset_id}/insights"
tags: ["Data Library"]
---

# Get Insights for a dataset identifier

`GET /v2/library/data/{dataset_id}/insights`

## Path parameters

- `dataset_id` string, required — Dataset identifier.

## Query parameters

- `page` integer — Page number
- `size` integer — Number of insights per page
- `sort_by` string, nullable — Field to sort insights by
- `order` string, nullable — Sort direction

## Request body

- object, nullable

## Response `200`

Successful Response

- InsightResponse
  - `total` integer, required
  - `page` integer, required
  - `size` integer, required
  - `pages` integer, required
  - `items` InsightResponseItem[], required
    - `insight_id` integer, required
    - `label` string, required
    - `sources` string[], nullable
    - `topic_label` string, nullable
    - `topic_key` string, nullable
    - `topic_id` integer, nullable
    - `subject_label` string, nullable
    - `subject_key` string, nullable
    - `subject_id` integer, nullable
    - `dataset_id` string, nullable
    - `insight_type_label` string, required
    - `insight_type` string, required
    - `is_event` boolean, nullable
    - `historic` boolean, nullable
    - `has_entity` boolean, nullable
    - `insight_name` string, nullable
    - `description` string, nullable
    - `subject_description` string, nullable
    - `topic_description` string, nullable
    - `delay_status` object, nullable
    - `last_updated_timestamp` string, date-time, nullable
    - `blocked` integer, nullable
    - `insight_overview` integer, nullable
    - `last_reinstated_timestamp` string, date-time, nullable
    - `reinstatement_reason` string, nullable
    - `table_max_date` string, date-time, nullable
    - `relevance_score` number, nullable
    - `ontology_version` string, nullable

## Other responses

- `404` — Not Found
- `422` — Validation Error

---

[API](https://skmtc.net/carbonarc/apis/carbon-arc-api-documentation.md) · [All operations](https://skmtc.net/carbonarc/apis/carbon-arc-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/carbonarc/carbon-arc-api-documentation/versions/bd33ea42994c/schema)