---
title: "Read Eli's source-linked understanding of the company"
method: GET
path: "/api/v2/company-intelligence"
tags: ["Workspace reads"]
---

# Read Eli's source-linked understanding of the company

`GET /api/v2/company-intelligence`

## Request

- Base URL: `https://www.hireeli.io`
- URL: `https://www.hireeli.io/api/v2/company-intelligence`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Returns verified, reported, observed, missing, conflicting and stale facts separately. No model or paid provider call occurs. Personalized activation must remain off unless agentContext.useForPersonalization is true.

## Headers

- `x-eli-tenant` string, uuid

## Response `200`

Tenant-pinned Company Intelligence document.

- CompanyIntelligenceResponse
  - `data` CompanyIntelligence, required
    - `version` 'company-intelligence-v1', required
    - `available` boolean, required
    - `generatedAt` string, date-time, required
    - `workspaceId` string, uuid, required
    - `revision` object, required
      - `memoryVersion` integer, required
    - `readiness` 'ready' | 'needs_input' | 'conflict' | 'unavailable', required
    - `coverageScore` integer, required: Coverage of required personalized context, not a business-quality score.
    - `facts` object, required: Grouped CompanyIntelligenceFact objects for identity, market, positioning, audience, offer, competition, demand, proof, conversion and constraints.
    - `gaps` object[], required
      - `key` string, required
      - `severity` 'blocking' | 'important' | 'optional', required
      - `question` string, required
      - `reason` string, required
    - `conflicts` object[], required
    - `unavailableSources` string[], required
    - `agentContext` object, required
    - `cost` object, required
      - `modelCalls` 0, required
      - `paidProviderCalls` 0, required
    - `truth` object, required

## Other responses

- `401`: Credential missing, invalid, expired or revoked.
- `403`: Workspace, role, scope, plan or feature does not permit this operation.
- `409`: Current lifecycle state conflicts with the requested decision.
- `429`: Request or durable protocol cap reached.
- `503`: A required security, billing, cap, audit, evidence or storage check is unavailable. Writes fail closed.

---

[API](https://skmtc.dev/hireeli/apis/eli-api.md) · [All operations](https://skmtc.dev/hireeli/apis/eli-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hireeli/apis/eli-api/revisions/3272729fecd2?raw)