---
title: "Search Entities For Insight"
method: GET
path: "/v2/prisms/ontology/entities"
tags: ["Prisms Internal"]
---

# Search Entities For Insight

`GET /v2/prisms/ontology/entities`

Entity typeahead for the CAMS prism form.

``insight_id`` is optional so operators can pick entities first; when set,
results are scoped to entities that support that insight (carc_ids are
representation-scoped). All-digit ``search`` values look up ``carc_id``
in Neo4j first, then append label matches that contain the same digits.

## Query parameters

- `insight_id` integer, nullable — When set, only entities that support this insight
- `search` string, nullable — Name/alias search; all-digit queries also match carc_id first
- `page` integer
- `size` integer

## Request body

- object, nullable

## Response `200`

Successful Response

- EntityResponse
  - `total` integer, required
  - `page` integer, required
  - `size` integer, required
  - `pages` integer, required
  - `entities` EntityResponseItem[], nullable
    - `entity` string, required
    - `entity_domain` string, nullable
    - `entity_domain_label` string, nullable
    - `entity_representation` string, required
    - `entity_representation_label` string, required
    - `label` string, required
    - `entity_id` integer, required
    - `entity_id_key` string, nullable
    - `figi_code` string, nullable
    - `metadata` object, nullable
    - `relevance_score` number, nullable
    - `carc_id` integer, required — Alias for entity_id for backward compatibility.
    - `representation` string, required — Alias for entity_representation for backward compatibility.

## 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/revisions/4850d81778a4/schema)