---
title: "Insights For Entity"
method: GET
path: "/v2/ontology/entity/{entity_id}/insights"
tags: ["Ontology"]
---

# Insights For Entity

`GET /v2/ontology/entity/{entity_id}/insights`

## Path parameters

- `entity_id` integer, required

## Query parameters

- `entity_representation` string, required — Entity representation
- `search` string, nullable — Search term
- `limit` integer, nullable — Limit the number of results
- `min_score` number, nullable — Minimum score for search results

## Request body

- object, nullable

## Response `200`

Successful Response

- InsightListResponse
  - `insights` Insight[], required
    - `insight_id` integer, required
    - `insight_name` string, required
    - `topic_id` integer, required
    - `topic_name` string, required
    - `is_event` boolean, nullable
  - `source_count` integer, nullable
  - `subject_count` integer, nullable

## Other responses

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

## Changes

- **2026-07-26** `6ba1ca74e6c7` — 1 info
  - added the optional property `insights/items/is_event` to the response with the `200` status

[Change history](https://skmtc.dev/carbonarc/apis/carbon-arc-api-documentation/changes/v2/ontology/entity/:entity_id/insights/get.md)

---

[API](https://skmtc.dev/carbonarc/apis/carbon-arc-api-documentation.md) · [All operations](https://skmtc.dev/carbonarc/apis/carbon-arc-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/carbonarc/apis/carbon-arc-api-documentation/revisions/81f915d799ee?raw)