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

# All Insights

`GET /v2/ontology/all-insights`

## Request

- Base URL: `https://api.carbonarc.co` (the document declares no server; this is the origin it was published from)
- URL: `https://api.carbonarc.co/v2/ontology/all-insights`
- Auth: none declared

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.

Every insight, but not every field: provider-blocked rows are flagged with
``blocked: true`` per caller rather than dropped -- matching ``/insights``,
which the browse panel renders locked and unselectable -- 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 — but only for the response that
actually needs the rows. A conditional request and an already-rendered body
are both settled by the version alone, and a live build made to reach
either was discarded whole.

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

## Changes

- **2026-07-31** `1d445d2a69b5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/carbonarc/apis/carbon-arc-api-documentation/changes/v2/ontology/all-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/7362ca3a398d?raw)