---
title: "Citizens (FL) depopulation (takeout) activity"
method: GET
path: "/v1/citizens/depopulation"
---

# Citizens (FL) depopulation (takeout) activity

`GET /v1/citizens/depopulation`

## Request

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

Aggregate mode (default): annual totals, optionally by policy_type. `detail=true`: per-assumption-date, per-company rows -- only populated for 2017, 2018, and 2021+; other years gracefully return an empty array. $0.10 per query.

## Query parameters

- `year` string
- `from` string
- `to` string
- `company` string
- `detail` 'true' | 'false'

## Response `200`

Depopulation rows, aggregate or detail depending on `detail`.

- object
  - `year` number, nullable, required
  - `from` number, nullable, required
  - `to` number, nullable, required
  - `company` string, nullable, required
  - `detail` boolean, required
  - `data` object[], required
    - `year` number, required
    - `assumption_date` string, nullable, required: YYYY-MM-DD; null for annual aggregate rows.
    - `company` string, nullable, required: Takeout company; null for annual aggregate rows.
    - `policy_type` 'PRM' | 'PRW' | 'CRM' | 'CRW' | 'null', nullable, required
    - `policies_assumed` number, required
    - `with_wind` number, nullable, required
    - `ex_wind` number, nullable, required
    - `exposure_removed` number, nullable, required
  - `report_date` string, nullable, required
  - `data_as_of` string, nullable, required: Latest year among returned rows, e.g. "2026".
  - `source` string, nullable, required

## Other responses

- `400`: Invalid query parameters.
- `402`: Payment required (x402). Returned when the x402 payment gate is enabled (PAY_TO_ADDRESS configured) and the request carries no valid payment. The full payment challenge (price/network/payTo/asset) is carried in the base64-encoded PAYMENT-REQUIRED response header (see the x402 spec), not the JSON body -- the body is `{}` for API clients. Price for this route: $0.10. Retry with a signed payment per x402 (USDC on Base mainnet); on success the response carries a PAYMENT-RESPONSE header with settlement info. When PAY_TO_ADDRESS is unset (kill switch off), this route is free and never returns 402.
- `500`: Internal error.

---

[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)