---
title: "Health Coverage"
method: GET
path: "/snapshots/{snapshot_id}/health/coverage"
tags: ["code-health"]
---

# Health Coverage

`GET /snapshots/{snapshot_id}/health/coverage`

## Request

- Base URL: `https://api.repowise.dev` (the document declares no server; this is the origin it was published from)
- URL: `https://api.repowise.dev/snapshots/{snapshot_id}/health/coverage`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/repowise/apis/repowise-hosted-api/docs/snapshots/:snapshot_id/health/coverage/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `snapshot_id` string, required

## Query parameters

- `offset` integer
- `limit` integer
- `module_limit` integer
- `include_inferred` boolean

## Response `200`

Successful Response

- HealthCoverageResponse
  - `overall_line_coverage_pct` number, nullable
  - `overall_branch_coverage_pct` number, nullable
  - `file_count_with_coverage` integer
  - `source_format` string, nullable
  - `ingested_at` string, nullable
  - `ingested_commit_sha` string, nullable
  - `source_formats` string[]
  - `mapping_partial` boolean, nullable
  - `report_paths` CoverageReportPaths: How the report's own file entries mapped to the repository at ingest.
    - `total` integer, required
    - `matched` integer, required
    - `unmatched` integer, required
    - `ambiguous` integer, required
    - `unmatched_sample` string[], required
  - `freshness` CoverageSummaryFreshness: Whether the coverage was measured at the commit the index describes.
    - `status` 'current' | 'stale' | 'unknown', required
    - `indexed_commit` string, nullable, required
  - `history` CoverageHistoryPoint[], nullable
    - `ingested_at` string, required
    - `ingested_commit_sha` string, nullable, required
    - `line_coverage_pct` number, required
    - `branch_coverage_pct` number, nullable, required
  - `files` CoverageFileRow[]
    - `file_path` string, required
    - `source_format` string, required
    - `line_coverage_pct` number, required
    - `branch_coverage_pct` number, nullable
    - `total_coverable_lines` integer
    - `ingested_at` string, nullable
    - `ingested_commit_sha` string, nullable
    - `health_score` number, nullable
    - `nloc` integer, nullable
  - `modules` CoverageModuleRow[]
    - `module` string, required
    - `files` integer, required
    - `covered_lines` integer, required
    - `total_lines` integer, required
    - `line_coverage_pct` number, required
  - `modules_total` integer
  - `total` integer
  - `basis` string, nullable
  - `inferred` InferredTestMap: The graph-inferred test map: counts, never a ratio. ``files_reached`` and ``files_not_reached`` are deliberately two counts rather than one fraction - a fraction invites a progress bar, and a progress bar is the coverage percentage this basis is not allowed to claim. ``files_total`` is the full count whatever ``files`` carries, so a paged list is never read as the whole repo.
    - `files` ReachedFileRow[]
      - `file_path` string, required
      - `reached` boolean, required
      - `health_score` number, nullable
      - `nloc` integer, nullable
    - `files_total` integer
    - `files_reached` integer
    - `files_not_reached` integer
    - `test_file_count` integer
  - `state` string
  - `reason` string, nullable

## Other responses

- `422`: Validation Error

## Changes

- **2026-09-30** `a814305b59f4`: 5 info
  - added the optional property `freshness` to the response with the `200` status
  - added the optional property `history` to the response with the `200` status
  - added the optional property `mapping_partial` to the response with the `200` status
  - added the optional property `report_paths` to the response with the `200` status
  - …1 more

[Operation history](https://skmtc.dev/repowise/apis/repowise-hosted-api/changes/snapshots/:snapshot_id/health/coverage/get.md)

---

[API](https://skmtc.dev/repowise/apis/repowise-hosted-api.md) - [All operations](https://skmtc.dev/repowise/apis/repowise-hosted-api/llms.txt) - [OpenAPI document](https://skmtc.dev/repowise/apis/repowise-hosted-api/revisions/3037f631a606?raw)
