FBI Get LEOKA
fbi_get_leokaRead-onlyIdempotent
LEOKA officer fatality trends, weapons, activity, circumstances, demographics, geographic regions, and time-of-day/month breakdowns. Period "ytd" requests a year; "monthly" requires month and includes comparison-year monthly series. Both periods return the CDE YTD totals block, separately from month-specific breakdowns. Raw dod/doi totals have unspecified interpretation; classified deaths remain in the trend and region series.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| year | Yes | Year to retrieve LEOKA data for. Required — the API does not default to a year. | |
| month | No | Month number (1–12). Required for monthly; must be omitted for YTD. | |
| period | Yes | Data period: ytd for the year, monthly for month-specific breakdowns and comparison years. Both include the CDE YTD totals block. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| year | No | The data year requested. | |
| error | No | Present when the call failed. Absent on success. | |
| month | No | The data month, when period is "monthly". | |
| period | No | The requested data period. | |
| totals | No | Raw incidents_victim_officer_totals_ytd block, including in monthly responses. Not combined fatalities or requested-month totals. | |
| weapons | No | Count by weapon type (e.g. Handguns, Rifles, Vehicle). | |
| deaths_by_year | No | Annual officer death totals by type. Keys: "Felonious", "Accidental". Values: { "2022": 61, ... } | |
| body_armor_worn | No | Body armor worn category to count; null counts are unavailable. | |
| deaths_by_region | No | Officer death counts by killing type then region. Keys: "Felonious", "Accidental". Values: { "South": 31, "West": 12, ... } | |
| officer_activity | No | Count by what the officer was doing at the time of the incident. | |
| location_of_attack | No | Location of attack category to count; all reported categories are retained. | |
| weather_conditions | No | Weather condition to count. | |
| lighting_conditions | No | Count by lighting conditions at time of incident. | |
| officer_demographic | No | Officer demographic dimension to category to count; null groups and counts are unavailable. | |
| offender_demographic | No | Offender demographic dimension to category to count; null groups and counts are unavailable. | |
| officer_incident_type | No | Officer incident type to count. | |
| officer_death_by_month | No | Killing type to year to month to count. Includes returned comparison years and zero values without filtering. | |
| officer_type_of_assignment | No | Officer assignment type to count. | |
| offender_prior_relationship | No | Offender prior relationship category to count. | |
| officer_death_by_time_of_day | No | Killing type to hour key to count. Hour keys, including -1, are preserved literally. | |
| offender_prior_mental_illness | No | Offender prior mental illness category to count. | |
| offender_previously_known_to_agency | No | Previously known offender category to count. | |
| officer_circumstances_time_of_attack | No | Circumstance at time of attack category to count. |