---
title: "Get one metric from the insights bundle"
method: GET
path: "/companies/{companyId}/insights/metrics/{metricKey}"
tags: ["Insights"]
---

# Get one metric from the insights bundle

`GET /companies/{companyId}/insights/metrics/{metricKey}`

## Request

- Base URL: `https://api.medianfi.com/api/v1`
- URL: `https://api.medianfi.com/api/v1/companies/{companyId}/insights/metrics/{metricKey}`
- Auth: HTTP bearer

## Query parameters

- `entityId` string, uuid
- `period` 'last_30_days' | 'last_90_days' | 'month_to_date'
- `startDate` string, date
- `endDate` string, date
- `industry` string

## Response `200`

Insight metric

- object
  - `success` boolean
  - `data` InsightMetric
    - `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

## Other responses

- `400`: Invalid query parameters
- `404`: Metric not found

---

[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)