---
title: "What data exists: states, date ranges, granularities"
method: GET
path: "/v1/coverage"
---

# What data exists: states, date ranges, granularities

`GET /v1/coverage`

## Request

- Base URL: `https://api.querylines.com`
- URL: `https://api.querylines.com/v1/coverage`
- Auth: none declared

Free -- discovery bait (CLAUDE.md). Cache-Control: public, max-age=3600.

## Response `200`

Coverage summary: `states` (per-state premium ranges, element shape unchanged from before migration 0005) plus `datasets`, a per-dataset capability map that grows as new datasets are added.

- object
  - `states` object[], required
    - `state` string, required
    - `name` string, required
    - `stamping_office` string, required
    - `period_types` object, required
    - `capabilities` object, required: Which migration-0003 data types have at least one row for this state.
      - `has_county_data` boolean, required: Annual county-level rows (GET /v1/premium?county=...).
      - `has_insurer_data` boolean, required: Per-insurer rows (GET /v1/insurers).
      - `has_new_renewal_split` boolean, required: new_business_policy_pct/renewal_policy_pct populated on some row.
  - `datasets` object, required
    - `premium` object, required
      - `kind` 'timeseries', required
      - `states` string[], required: State codes with at least one premium_facts row.
      - `endpoints` string[], required
    - `eligibility` object, required: NAIC IID (Quarterly Listing of Alien Insurers) coverage. latest_edition is null before the first load.
      - `kind` 'registry', required
      - `scope` string, required: e.g. "nationwide (NRRA)"
      - `authorities` string[], required
      - `latest_edition` object, nullable, required
        - `edition_no` number
        - `report_date` string
      - `entities` object, required
        - `alien_companies` number, required
        - `lloyds_syndicates` number, required
      - `endpoints` string[], required
    - `citizens` object, required: Citizens Property Insurance Corporation (Florida) coverage. Ranges are null before the first load.
      - `kind` 'timeseries', required
      - `state` 'FL', required
      - `series` string[], required
      - `pif_range` object, nullable, required
        - `from` string: YYYY-MM
        - `to` string: YYYY-MM
      - `depop_range` object, nullable, required
        - `from` string: YYYY
        - `to` string: YYYY
      - `endpoints` string[], required
    - `carriers` object, required: NAIC Market Share Report (P/C) coverage, migration 0007. Fields are 0/null before the first load.
      - `kind` 'registry', required
      - `years` object, nullable, required
        - `from` number
        - `to` number
      - `jurisdictions` number, required: Distinct state codes with at least one row.
      - `lines` number, required: Distinct line_codes with at least one row.
      - `latest_report_date` string, nullable, required
      - `endpoints` string[], required
    - `rate_filings` object, required: SERFF admitted-market rate filings (Texas TDI open data, Mississippi MID bulletins, California CDI rate-filing approvals, and Washington OIC annual reports), migration 0013 -- a leading indicator of surplus-lines (E&S) growth. Fields are 0/null before the first load.
      - `kind` 'registry', required
      - `states` string[], required: Distinct state codes with at least one current filing.
      - `received_date_range` object, nullable, required: Across all states; note Mississippi filings never carry a received_date.
        - `from` string
        - `to` string
      - `filing_count` number, required: Distinct current-row filings across both states.
      - `categories` number, required: Distinct coverage_category values with at least one row.
      - `granularities` string[], required
      - `latest_report_date` string, nullable, required
      - `endpoints` string[], required

---

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