---
title: "Mortality Report"
method: GET
path: "/api/v1/stats/mortality"
tags: ["stats"]
---

# Mortality Report

`GET /api/v1/stats/mortality`

## Request

- Base URL: `https://api.billcommons.org`
- URL: `https://api.billcommons.org/api/v1/stats/mortality`
- Auth: none declared

Aggregate current bill statuses for public state/DC jurisdictions.

The report includes every stored bill in the public jurisdictions and does
not filter by calendar year or legislative session. Terminal statuses are
reported separately and as the `did_not_pass` sum; missing or unrecognized
statuses remain in `unknown`.

## Response `200`

Successful Response

- MortalityReportEnvelope
  - `data` MortalityJurisdictionRow[], required
    - `jurisdiction_code` string, required
    - `jurisdiction_name` string, required
    - `total` integer, required
    - `enacted` integer, required
    - `died_on_adjournment` integer, required
    - `killed` integer, required
    - `pending` integer, required
    - `unknown` integer, required
    - `enacted_pct` number, nullable
    - `died_on_adjournment_pct` number, nullable
    - `did_not_pass` integer
    - `did_not_pass_pct` number, nullable
    - `killed_pct` number, nullable
    - `terminal_split_is_degenerate` boolean
    - `has_active_session` boolean, required
  - `totals` MortalityTotals, required
    - `total` integer, required
    - `enacted` integer, required
    - `died_on_adjournment` integer, required
    - `killed` integer, required
    - `did_not_pass` integer
    - `did_not_pass_pct` number, nullable
    - `pending` integer, required
    - `unknown` integer, required
    - `enacted_pct` number, nullable
    - `died_on_adjournment_pct` number, nullable
  - `meta` object, required

---

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