---
title: "Surface Coverage"
method: GET
path: "/v1/projects/{project_id}/surface-coverage"
tags: ["reports"]
---

# Surface Coverage

`GET /v1/projects/{project_id}/surface-coverage`

## Request

- Base URL: `https://api.sonenta.dev`
- URL: `https://api.sonenta.dev/v1/projects/{project_id}/surface-coverage`
- Auth: none declared

Per-active-surface completeness ('surface X = N% covered'). a11y surfaces
report true completeness (eligible = type-relevant keys); device surfaces
report override density (optional — un-overridden cells fall back to base).

## Path parameters

- `project_id` string, required

## Query parameters

- `version_id` string, nullable

## Response `200`

Successful Response

- SurfaceCoverageOut
  - `project_uuid` string, required
  - `version_uuid` string, nullable, required
  - `languages` string[], required
  - `keys_total` integer, required
  - `surfaces` SurfaceCoverageItem[], required
    - `surface` string, required
    - `label` string, required
    - `kind` string, required
    - `meaning` string, required
    - `eligible_keys` integer, required
    - `eligible_cells` integer, required
    - `present_cells` integer, required
    - `pct` integer, required
    - `by_language` SurfaceCoverageLanguage[], required
      - `code` string, required
      - `eligible` integer, required
      - `present` integer, required
      - `pct` integer, required

## Other responses

- `422`: Validation Error

---

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