---
title: "Get the feature-flagged founder Intelligence Home"
method: GET
path: "/companies/{companyId}/intelligence/home"
tags: ["Insights"]
---

# Get the feature-flagged founder Intelligence Home

`GET /companies/{companyId}/intelligence/home`

## Request

- Base URL: `https://api.medianfi.com/api/v1`
- URL: `https://api.medianfi.com/api/v1/companies/{companyId}/intelligence/home`
- Auth: HTTP bearer

Returns the deterministic metric bundle, monthly curation, founder brief, operating signals, data readiness gaps, and deeper report pointers for the company. Customer-visible guidance is built only from validated signals and approved insights.

## Query parameters

- `entityId` string, uuid

## Response `200`

Intelligence Home

- IntelligenceHomeResponse
  - `success` boolean
  - `data` IntelligenceHome
    - `companyId` string, required
    - `entityId` string, uuid, required
    - `homeState` 'active_curated' | 'active_needs_review' | 'fallback_unreviewed' | 'blocked', required
    - `period` object, required
    - `businessContext` object, required
    - `brief` IntelligenceHomeBrief, required
      - `title` string, required
      - `primaryDecision` string, required
      - `whatChanged` string, required
      - `whyItMatters` string, required
      - `nextAction` string, required
      - `confidence` 'ready' | 'stale' | 'low_confidence' | 'blocked', required
      - `confidenceLabel` string, required
      - `sourceRefs` MetricSourceRef[], required
        - `type` 'overview' | 'report' | 'aging' | 'marketing' | 'stripe' | 'document' | 'transaction' | 'manual', required
        - `id` string, required
        - `label` string, required
      - `supportingSignals` string[], required
      - `missingData` string[], required
      - `deeperReport` object, nullable
    - `curation` IntelligenceHomeCuration, required
      - `id` string
      - `companyId` string, required
      - `entityId` string, uuid, required
      - `periodStart` string, date, required
      - `periodEnd` string, date, required
      - `periodLabel` string, required
      - `status` 'draft' | 'active' | 'archived', required
      - `selectedItems` IntelligenceHomeCurationItem[], required
        - `kind` 'metric' | 'report', required
        - `key` string, required
        - `title` string, required
        - `rationale` string, required
        - `priority` integer, required
        - `sourceRefs` MetricSourceRef[], required
          - `type` 'overview' | 'report' | 'aging' | 'marketing' | 'stripe' | 'document' | 'transaction' | 'manual', required
          - `id` string, required
          - `label` string, required
      - `rationale` string, required
      - `sourceRefs` MetricSourceRef[], required
        - `type` 'overview' | 'report' | 'aging' | 'marketing' | 'stripe' | 'document' | 'transaction' | 'manual', required
        - `id` string, required
        - `label` string, required
      - `inputHash` string, required
      - `promptVersion` string, required
      - `model` string, nullable, required
      - `validationIssues` object[], required
        - `code` string, required
        - `severity` 'blocking' | 'warning', required
        - `message` string, required
        - `owner` 'system' | 'integrations' | 'accounting' | 'attribution' | 'ai_review', required
        - `sourceKey` string, nullable
      - `validationErrors` string[], required
      - `validationWarnings` string[], required
      - `supersedesCurationId` string, nullable, required
      - `reviewDecision` 'approved' | 'needs_review' | 'blocked' | 'null', nullable, required
      - `reviewerType` 'ai_assisted_system' | 'null', nullable, required
      - `reviewedAt` string, date-time, nullable, required
      - `reviewModel` string, nullable, required
      - `reviewReasons` string[], required
      - `reviewBlockers` string[], required
      - `generatedAt` string, date-time, required
      - `promotedAt` string, date-time, nullable, required
    - `signals` IntelligenceHomeSignal[], required
      - `key` string, required
      - `metricKey` string, required
      - `label` string, required
      - `value` union, required
        - number
        - object
      - `unit` string, required
      - `period` object, required
      - `comparison` object, required
        - `delta` number, nullable
        - `label` string, nullable
      - `qualityState` 'ready' | 'stale' | 'low_confidence' | 'blocked', required
      - `sourceRefs` MetricSourceRef[], required
        - `type` 'overview' | 'report' | 'aging' | 'marketing' | 'stripe' | 'document' | 'transaction' | 'manual', required
        - `id` string, required
        - `label` string, required
      - `rationale` string, required
      - `unavailableReason` string, nullable
      - `qualityMessages` string[]
    - `reports` IntelligenceHomeReport[], required
      - `key` string, required
      - `title` string, required
      - `description` string, required
      - `path` string, nullable, required
      - `qualityState` 'ready' | 'stale' | 'low_confidence' | 'blocked', required
      - `rationale` string, required
      - `sourceRefs` MetricSourceRef[], required
        - `type` 'overview' | 'report' | 'aging' | 'marketing' | 'stripe' | 'document' | 'transaction' | 'manual', required
        - `id` string, required
        - `label` string, required
    - `metrics` object, required
    - `curatedMetrics` object[], required
      - `item` IntelligenceHomeCurationItem, required
        - `kind` 'metric' | 'report', required
        - `key` string, required
        - `title` string, required
        - `rationale` string, required
        - `priority` integer, required
        - `sourceRefs` MetricSourceRef[], required
          - `type` 'overview' | 'report' | 'aging' | 'marketing' | 'stripe' | 'document' | 'transaction' | 'manual', required
          - `id` string, required
          - `label` string, required
      - `metric` InsightMetric, required
        - `key` string, required
        - `label` string, required
        - `value` union, required
          - number
          - object
        - `unit` 'usd' | 'cents' | 'months' | 'percent' | 'count' | 'days' | 'ratio' | 'object', required
        - `delta` number, nullable, required
        - `series` MetricSeriesPoint[], required
          - `date` string, date, required
          - `value` number, required
          - `originalValue` number
          - `annotations` MetricQualityFlag[]
            - `type` 'reconciliation_gap' | 'outlier_dampened' | 'marketing_attribution_gap' | 'platform_reporting_only', required
            - `severity` 'info' | 'warning', required
            - `message` string, required
            - `metadata` object
        - `sourceRefs` MetricSourceRef[], required
          - `type` 'overview' | 'report' | 'aging' | 'marketing' | 'stripe' | 'document' | 'transaction' | 'manual', required
          - `id` string, required
          - `label` string, required
        - `qualityFlags` MetricQualityFlag[], required
          - `type` 'reconciliation_gap' | 'outlier_dampened' | 'marketing_attribution_gap' | 'platform_reporting_only', required
          - `severity` 'info' | 'warning', required
          - `message` string, required
          - `metadata` object
        - `computedAt` string, date-time, required
        - `staleness` 'fresh' | 'stale' | 'unavailable', required
        - `unavailableReason` string, nullable, required
    - `evidenceStrip` object[], required
      - `key` string, required
      - `label` string, required
      - `value` string, required
      - `qualityState` 'ready' | 'stale' | 'low_confidence' | 'blocked', required
      - `verifiedAsOf` string, date-time, nullable, required
      - `sourceRefs` MetricSourceRef[], required
        - `type` 'overview' | 'report' | 'aging' | 'marketing' | 'stripe' | 'document' | 'transaction' | 'manual', required
        - `id` string, required
        - `label` string, required
    - `verificationTimeline` object[], required
      - `key` string, required
      - `label` string, required
      - `state` 'source_synced' | 'ai_reviewed' | 'accounting_reviewed' | 'reviewing' | 'blocked' | 'pending', required
      - `detail` string, required
      - `updatedAt` string, date-time, nullable, required
      - `sourceRefs` MetricSourceRef[], required
        - `type` 'overview' | 'report' | 'aging' | 'marketing' | 'stripe' | 'document' | 'transaction' | 'manual', required
        - `id` string, required
        - `label` string, required
    - `dataReadiness` object, required
      - `state` 'ready' | 'stale' | 'low_confidence' | 'blocked', required
      - `summary` string, required
      - `verifiedAsOf` string, date-time, nullable, required
      - `blockers` object[], required
      - `warnings` object[], required
    - `openNext` object, nullable, required
      - `key` string, required
      - `title` string, required
      - `description` string, required
      - `path` string, nullable, required
      - `qualityState` 'ready' | 'stale' | 'low_confidence' | 'blocked', required
      - `sourceRefs` MetricSourceRef[], required
        - `type` 'overview' | 'report' | 'aging' | 'marketing' | 'stripe' | 'document' | 'transaction' | 'manual', required
        - `id` string, required
        - `label` string, required
    - `dataHealth` object, required
    - `topInsights` object[], required
    - `pendingInsightCount` integer, required

## Other responses

- `401`: Authentication required
- `403`: Insufficient permissions or not a company member

---

[API](https://skmtc.dev/medianfi/apis/median-api.md) · [All operations](https://skmtc.dev/medianfi/apis/median-api/llms.txt) · [OpenAPI document](https://skmtc.dev/medianfi/apis/median-api/revisions/20090ea32b0d?raw)