---
title: "Free sample: FL top-5 carriers, total_all_lines, latest year"
method: GET
path: "/v1/carriers/sample"
---

# Free sample: FL top-5 carriers, total_all_lines, latest year

`GET /v1/carriers/sample`

## Request

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

Free -- the teaser for /v1/carriers. Florida, total_all_lines, latest data year, top 5 carriers only. Other states/scopes, other lines, the full top-125/top-10 rankings, carrier profile trajectories, and cross-state footprint comparisons are paid.

## Response `200`

FL top-5 carriers for total_all_lines, latest year, plus total/all_other/concentration.

- object
  - `state` 'FL', required
  - `line` 'total_all_lines', required
  - `year` number, nullable, required
  - `sample` boolean, required
  - `carriers` object[], required
    - `rank` number, required
    - `entity_kind` 'group' | 'company', required: Groups (NAIC group code) and standalone companies (cocode) are ranked in ONE table, per the report's own methodology.
    - `naic_code` string, nullable, required
    - `name` string, nullable, required
    - `dpw` number, nullable, required: Direct premiums written, USD.
    - `dpe` number, nullable, required: Direct premiums earned, USD.
    - `loss_ratio` number, nullable, required: Percent, 0-100.
    - `lcc_ratio` number, nullable, required: Loss & cost containment ratio, percent.
    - `market_share` number, nullable, required: Percent, 0-100.
    - `cumulative_market_share` number, nullable, required: Running cumulative percent through this rank.
    - `yoy_dpw_pct` number, nullable, required: Year-over-year dpw percent change; null when the prior year has no row for this entity.
    - `share_delta_pts` number, nullable, required: market_share this year minus last year, in percentage points; null when the prior year has no row.
  - `total` object, nullable, required: The printed STATE TOTAL / INDUSTRY TOTAL row -- the full-market denominator. null if the year/scope has no data.
    - `dpw` number, nullable, required
    - `dpe` number, nullable, required
    - `loss_ratio` number, nullable, required
    - `lcc_ratio` number, nullable, required
  - `all_other` object, nullable, required: Synthesized residual (total minus the printed top-N) -- top-N + all_other = 100%. null if the year/scope has no data.
    - `dpw` number, nullable, required
    - `market_share` number, nullable, required
  - `concentration` object, required: HHI is not computable from a truncated top-N table; CR4/CR10 are read off cumulative_market_share instead, independent of `limit`.
    - `cr4` number, nullable, required: cumulative_market_share at rank 4; null if the table has fewer than 4 ranks.
    - `cr10` number, nullable, required: cumulative_market_share at rank 10; null if the table has fewer than 10 ranks.
  - `report_date` string, nullable, required
  - `data_as_of` string, nullable, required
  - `source` string, nullable, required
  - `coverage_note` string, required: Top-125 countrywide / top-10 per jurisdiction ONLY -- absence from these results does NOT mean a carrier writes no business there. Repeated verbatim on every response (see GET /v1/carriers/lines).
  - `note` 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)