---
title: "Get Coverage"
method: GET
path: "/meta/coverage"
tags: ["Meta"]
---

# Get Coverage

`GET /meta/coverage`

Returns per-field data coverage tiers (partial or missing) for the specified geography and date range. Fields classified as reliable (fill rate >= 80%) are omitted. Empty windows return all 10 tracked fields as missing with permits_total=0.

## Query parameters

- `geo_type` 'state' | 'county' | 'city' | 'zipcode' | 'jurisdiction', required — One of 'state', 'county', 'city', 'zipcode', 'jurisdiction'. Determines how geo_id is parsed.
- `geo_id` string, required — 2-letter state code, 5-digit ZIP, or base64 geolocation ID for city/county/jurisdiction.
- `date_from` string, date, required — Inclusive lower bound of the window. Format: YYYY-MM-DD. The coverage year set includes every year the range touches.
- `date_to` string, date, required — Inclusive upper bound of the window. Format: YYYY-MM-DD. Must be >= date_from.

## Response `200`

Per-field coverage rows ordered by tier then field.

- CoverageResponse — Response envelope for `/v2/meta/coverage`. Bounded to at most 10 items (one per tracked field); no pagination.
  - `items` CoverageItem[], required — Per-field coverage rows for fields in the partial or missing tier, ordered by tier then field.
    - `field` 'fees' | 'job_value' | 'description' | 'contractor_id' | 'owner_name' | 'property_type' | 'property_year_built' | 'property_building_area' | 'issue_date' | 'file_date', required — Tracked permit field name (without 'has_' prefix).
    - `tier` 'missing' | 'partial' | 'reliable', required — Coverage classification: 'missing' (fill_pct < 0.10), 'partial' (0.10 <= fill_pct < 0.80), 'reliable' (fill_pct >= 0.80). The endpoint omits 'reliable' rows from the response.
    - `fill_pct` number, required — Fraction of permits in the window with a populated value for this field, rounded to 3 decimals. 0.0 when permits_total is 0.
    - `permits_total` integer, required — Total permits in the requested (geo, date range) window across all tracked years.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/shovels/apis/the-shovels-api-v2.md) · [All operations](https://skmtc.net/shovels/apis/the-shovels-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/shovels/the-shovels-api-v2/versions/d3f0e1f3afa8/schema)