FBI Get NIBRS Breakdown
fbi_get_nibrs_breakdownRead-onlyIdempotent
NIBRS incident breakdowns reported to FBI CDE for one offense, for the nation, a state, or an agency, summed over a month window from January 1991 through the current year. Returns victim counts by age, sex, race, location, ethnicity, and relationship to the offender; offender counts by age, sex, race, and ethnicity; and offense counts by weapon and related offense, with every category CDE reports, zeros included. Each dimension is tallied separately and their sums can differ, so no dimension stands in for another's total. offense is required (codes are listed on the field). National scope omits identifiers; state requires only state_abbr; agency requires only ori (look it up with fbi_search_agencies). When CDE has no value for any category, as for an unrecognized state or ORI, a window with no NIBRS data, or an offense with no reported incidents in the window, the call fails with no_data.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ori | No | Nine ASCII-letter/digit ORI code (e.g. CA0010400, DCMPD0000); case-insensitive. Find an agency's ORI with fbi_search_agencies. Only permitted and required for agency scope. | |
| scope | Yes | Geographic scope: national (omit identifiers), state (only state_abbr), or agency (only ori). | |
| offense | Yes | NIBRS offense code to break down (required; case-insensitive). Codes: 100 Kidnapping/Abduction; 101 Treason; 103 Espionage; 120 Robbery; 200 Arson; 210 Extortion/Blackmail; 220 Burglary/Breaking & Entering; 240 Motor Vehicle Theft; 250 Counterfeiting/Forgery; 270 Embezzlement; 280 Stolen Property Offenses; 290 Destruction/Damage/Vandalism of Property; 360 Failure to Register as a Sex Offender; 370 Pornography/Obscene Material; 510 Bribery; 520 Weapon Law Violations; 521 Violation of National Firearm Act of 1934; 522 Weapons of Mass Destruction; 526 Explosives Violation; 620 Wildlife Trafficking; 720 Animal Cruelty; 09A Murder and Nonnegligent Manslaughter; 09B Negligent Manslaughter; 09C Justifiable Homicide; 11A Rape; 11B Sodomy; 11C Sexual Assault With An Object; 11D Criminal Sexual Contact; 13A Aggravated Assault; 13B Simple Assault; 13C Intimidation; 23A Pocket-picking; 23B Purse-snatching; 23C Shoplifting; 23D Theft From Building; 23E Theft From Coin-Operated Machine or Device; 23F Theft From Motor Vehicle; 23G Theft of Motor Vehicle Parts or Accessories; 23H All Other Larceny; 26A False Pretenses/Swindle/Confidence Game; 26B Credit Card/Automated Teller Machine Fraud; 26C Impersonation; 26D Welfare Fraud; 26E Wire Fraud; 26F Identity Theft; 26G Hacking/Computer Invasion; 26H Money Laundering; 30A Illegal Entry into the United States; 30B False Citizenship; 30C Smuggling Aliens; 30D Re-entry after Deportation; 35A Drug/Narcotic Violations; 35B Drug Equipment Violations; 36A Incest; 36B Statutory Rape; 39A Betting/Wagering; 39B Operating/Promoting/Assisting Gambling; 39C Gambling Equipment Violation; 39D Sports Tampering; 40A Prostitution; 40B Assisting or Promoting Prostitution; 40C Purchasing Prostitution; 49A Harboring Escapee/Concealing from Arrest; 49B Flight to Avoid Prosecution; 49C Flight to Avoid Deportation; 58A Import Violations; 58B Export Violations; 61A Federal Liquor Offenses; 61B Federal Tobacco Offenses; 64A Human Trafficking, Commercial Sex Acts; 64B Human Trafficking, Involuntary Servitude. | |
| to_year | Yes | End year of the data range (inclusive), 1991 through the current year. | |
| to_month | No | End month (1–12). Defaults to December. | |
| from_year | Yes | Start year of the data range (inclusive), 1991 through the current year. The API uses monthly granularity. | |
| from_month | No | Start month (1–12). Defaults to January. | |
| state_abbr | No | Two ASCII-letter state abbreviation (e.g. CA, DC, PR); case-insensitive. Only permitted and required for state scope. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | Last month of the summed window (MM-YYYY). | |
| ori | No | Uppercased ORI code; present only for agency scope. | |
| from | No | First month of the summed window (MM-YYYY). | |
| error | No | Present when the call failed. Absent on success. | |
| scope | No | Geographic scope queried. | |
| victim | No | Victim counts summed over the window. | |
| offense | No | NIBRS offense code applied. | |
| offender | No | Offender counts summed over the window. | |
| state_abbr | No | Uppercased state abbreviation; present only for state scope. | |
| max_data_date | No | Latest data month CDE reports (MM/YYYY); absent when CDE omits it. | |
| offense_label | No | CDE label for the applied offense code. | |
| offense_details | No | CDE's offense section (weapons and related offenses) summed over the window. | |
| data_last_updated | No | Date CDE last refreshed NIBRS data; absent when CDE omits it. |