---
title: "All Insights"
method: GET
path: "/v2/ontology/all-insights"
tags: ["Ontology"]
---

# All Insights

`GET /v2/ontology/all-insights`

The whole insight corpus in one shot.

Served from the in-process store so the builder fetches once and filters
client-side. Unpaginated on purpose: the previous ``size=1000`` bulk reads
silently truncated a corpus that has since passed 1,200. ``version`` is
also the ETag, so a client holding it revalidates into a 304.

Not literally every insight: provider-blocked rows are dropped per caller,
and the projection omits ``description``, ``subject_description`` and
``delay_status``. ``/insights`` remains the paginated, searchable listing
with full metadata — it is the public SDK's contract.

Served from the published store; when nothing is published for the current
ontology version the corpus is built live for this one response.

## Response `200`

Successful Response

- InsightStoreResponse — Whole insight corpus, served in one shot for client-side search. Unpaginated by design — the corpus is ~1.2k rows and the builder filters it in memory. ``version`` is the graph version stamp and doubles as the ETag, so a client holding it revalidates into a 304.
  - `version` string, required
  - `total` integer, required
  - `items` InsightStoreItem[], required
    - `insight_id` integer, required
    - `label` string, required
    - `insight_name` string, nullable
    - `sources` string[], nullable
    - `topic_id` integer, nullable
    - `topic_key` string, nullable
    - `topic_label` string, nullable
    - `topic_description` string, nullable
    - `subject_id` integer, nullable
    - `subject_key` string, nullable
    - `subject_label` string, nullable
    - `dataset_id` string, nullable
    - `insight_type` string, nullable
    - `insight_type_label` string, nullable
    - `is_event` boolean, nullable
    - `historic` boolean, nullable
    - `has_entity` boolean, nullable
    - `blocked` integer, nullable
    - `insight_overview` integer, nullable
    - `last_updated_timestamp` string, date-time, nullable

## Other responses

- `404` — Not Found

---

[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/revisions/fd615712e250/schema)