---
title: "Entity Core Intelligence Profile (Pro+) — ten authority/readability scores, topic ownership, entity graph, competitors, perception map, strategic actions, and live-web grounding provenance."
method: GET
path: "/entities/{entityId}/core-intelligence"
tags: ["Layer 2 — Insight"]
---

# Entity Core Intelligence Profile (Pro+) — ten authority/readability scores, topic ownership, entity graph, competitors, perception map, strategic actions, and live-web grounding provenance.

`GET /entities/{entityId}/core-intelligence`

## Request

- Base URL: `https://entidex.com/api/v1`
- URL: `https://entidex.com/api/v1/entities/{entityId}/core-intelligence`
- Auth: HTTP bearer

Read-only projection of the latest stored Entity Core Intelligence Profile. Returns 404 when no profile has been built for the entity yet. Tier gate: layer_2_insight. The ten Core scores are an internal authority/readability model, not the canonical headline Score dimensions, and carry no Confidence Layer.

## Path parameters

- `entityId` string, required

## Response `200`

OK

- object
  - `data` CoreIntelligence: Entity Core Intelligence Profile projection. The ten scores are an internal authority/readability model (0–100), NOT the canonical §3 Score dimensions, and carry no Confidence Layer; auditability is via version, runCount, lastUpdated, and grounding.
    - `entityId` string, required: Canonical entity slug (mirrors the URL entityId).
    - `entityName` string, required
    - `version` integer, required
    - `lastUpdated` string, date-time, required
    - `runCount` integer, required
    - `summary` string, required: One-paragraph plain-English explanation of the entity.
    - `primaryClassification` string, required
    - `blendedScore` number, required: Weighted blend of the ten scores (0–100).
    - `scores` object, required
      - `clarity` number, required
      - `authority` number, required
      - `trust` number, required
      - `entityGraph` number, required
      - `topicalAuthority` number, required
      - `recommendation` number, required
      - `marketClarity` number, required
      - `machineReadability` number, required
      - `momentum` number, required
      - `reputationSafety` number, required: 0 = high reputation risk, 100 = low risk.
    - `topicOwnership` object[], required
      - `topic` string
      - `strength` string
      - `reason` string
    - `strongAssociations` object[], required
      - `name` string
      - `type` string
      - `relationship` string
    - `competitors` object[], required
      - `name` string
      - `overlap` string
    - `perception` object, required
      - `positive` string[]
      - `neutral` string[]
      - `negative` string[]
    - `strategicActions` string[], required
    - `grounding` object, nullable, required: Live-web grounding provenance for the most recent run, or null if never grounded.
      - `status` 'active' | 'unavailable'
      - `groundedAt` string, date-time
      - `searchResults` integer
      - `newsArticles` integer
      - `latestSourceDate` string
      - `sources` object[]
        - `url` string
        - `title` string
        - `publishedAt` string
        - `kind` 'news' | 'web'
      - `note` string
  - `meta` ResponseMeta
    - `requestId` string, required
    - `timestamp` string, date-time, required
    - `apiVersion` string, required
    - `pagination` object
      - `cursor` string, nullable
      - `hasMore` boolean
      - `limit` integer
    - `rateLimit` object
      - `limit` integer
      - `remaining` integer
      - `resetAt` string, date-time
    - `billing` object
      - `creditsUsed` integer
      - `creditsRemaining` integer, nullable
      - `tier` 'free' | 'layer_0_discovery' | 'layer_1_profile' | 'layer_2_insight' | 'layer_3_drift' | 'layer_4_cohort'
      - `allowedLayers` integer[]: Cumulative layer ladder unlocked by this key (0=discovery … 4=cohort). free → []; layer_2_insight → [0,1,2].
      - `mode` 'demo' | 'free' | 'payg' | 'keyed': How the caller is billed: demo (feedback-loop key), free (monthly allowance), payg (Developer PAYG), keyed (paid subscription).
  - `errors` ApiError[]
    - `code` 'ENTITY_NOT_RESOLVED' | 'ENTITY_NOT_FOUND' | 'INVALID_PARAMETER' | 'RATE_LIMITED' | 'INSUFFICIENT_CREDITS' | 'TIER_NOT_AVAILABLE' | 'UNAUTHENTICATED' | 'FORBIDDEN' | 'INTERNAL_ERROR', required
    - `message` string, required
    - `field` string
    - `candidates` object[]

## Other responses

- `404`: Entity or resource not found.

---

[API](https://skmtc.dev/entidex/apis/entidex-api.md) · [All operations](https://skmtc.dev/entidex/apis/entidex-api/llms.txt) · [OpenAPI document](https://skmtc.dev/entidex/apis/entidex-api/revisions/86b92f21a09a?raw)