---
title: "Read the published engineering KPI tables"
method: GET
path: "/internal/engineering-kpis"
---

# Read the published engineering KPI tables

`GET /internal/engineering-kpis`

## Request

- Base URL: `https://api.medianfi.com/api/v1`
- URL: `https://api.medianfi.com/api/v1/internal/engineering-kpis`
- Auth: HTTP bearer

Staff-only read of issue2977. Exactly nine engineering metrics for the supplied24-hour,7-day and30-day periods. Values preserve published rounding; exact windows, cohorts and detailed coverage are unavailable. No query parameters or producer writes. Responses are private and no-store.

## Response `200`

Engineering snapshot, possibly stale or partial

- object
  - `success` true, required
  - `data` object, required
    - `contractVersion` 'github-issue-tables-v1', required
    - `sourceUrl` string, uri, required
    - `sourceAsOf` string, date-time, required
    - `sourceUpdatedAt` string, date-time, required
    - `metadataStatus` 'unavailable', required
    - `refreshStatus` 'ok' | 'failed', required
    - `isStale` boolean, required
    - `periods` object[], required
      - `id` 'daily' | 'weekly' | 'monthly', required
      - `label` string, required
      - `metrics` object[], required
        - `id` 'issues_completed' | 'net_issue_count_change' | 'open_issue_average_age' | 'issue_average_age_at_completion' | 'code_efficiency' | 'code_effectiveness' | 'open_pr_count' | 'oldest_open_pr_age' | 'pr_open_to_close', required
        - `label` string, required
        - `unit` 'count' | 'days' | 'ratio', required
        - `displayValue` string, nullable, required
        - `status` 'observed' | 'partial' | 'unknown', required
        - `sampleN` integer, required

## Other responses

- `401`: Missing or expired authentication
- `403`: Current staff capability required; API/service principals excluded
- `422`: Unsupported query parameters
- `503`: Source unconfigured or unavailable with no last-good snapshot

---

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