Skip to content

Instantly share code, notes, and snippets.

@the-smartforce-team
Last active April 18, 2022 19:43
Show Gist options
  • Star 1 You must be signed in to star a gist
  • Fork 0 You must be signed in to fork a gist
  • Save the-smartforce-team/7d2da7337019a0829c1768399167ff27 to your computer and use it in GitHub Desktop.
Save the-smartforce-team/7d2da7337019a0829c1768399167ff27 to your computer and use it in GitHub Desktop.
DCJ JSON documentation by SmartForce

JSON examples

Use case - multiple UoF, four locations

JSON dictionary

general_information

Description

Main element of the contact

Type

Object

Required

true

general_information.agency_name

Description

Used to indicate the name of the reporting agency.

Type

String

Required

true

general_information.agency_ori

Description

Used to indicate the Incident owning agency Originating Agency Identifier.

Type

String

Required

true

Validation
  • The value must be nine (9) characters in length.

general_information.officer_id_number

Description

Used to indicate the ID number of the reporting officer.

Type

String

Required

true

general_information.officer_name

Description

Used to indicate the name of the reporting officer.

Type

String

Required

true

general_information.officer_post_number

Description

Used to indicate the Peace Officer Standards & Training number.

Type

String

Required

false

general_information.initiation

Description

Used to indicate what initiated the contact.

Type

String

Options
  • Call for Service
  • Officer Pro-active
Required

true

general_information.incident_number

Description

Used to indicate your agency internal contact number.

Type

String

Validation
  • Up to 20 characters.
  • Only numbers, letters, and hyphens(-) are allowed.
Required

true

general_information.date

Description

Used to indicate the date of the contact.

Type

String

Required

true

Format
  • MM/DD/YYYY
  • MM = two-digit month (01=January, etc.)
  • DD = two-digit day of month (01 through 31)
  • YYYY = four-digit year

general_information.time

Description

Used to indicate the time of the contact.

Type

String

Required

true

Format
  • hh:mm
  • hh = two digits of hour (00 through 23) (am/pm NOT allowed)
  • mm = two digits of minute (00 through 59)

general_information.location.address

Description

Used to indicate whether the address of the Contact incident.

Type

Object

Required

true

general_information.location.address.main

Description

Used to provide the street address of the Contact incident.

Type

String

Required

true

Validation
  • Maximum length is 120 characters
  • TextString including the following special characters – comma (,), period (.), hyphen (-), forward slash (/), ampersand (&), apostrophe (‘), and pound (#)

general_information.location.details

Description

Used to capture additional address information for the incident

Type

String

Required

false

Validation
  • Maximum length is 120 characters
  • TextString including the following special characters – comma (,), period (.), hyphen (-), forward slash (/), ampersand (&), apostrophe (‘), and pound (#)

general_information.location.address.city

Description

Used to indicate the city where the incident occurred.

Type

String

Required

false

Validation
  • Maximum length is forty (40) characters
  • TextString including the following special characters – comma (,), period (.), hyphen (-), forward slash (/), ampersand (&), apostrophe (‘) and pound (#)

general_information.location.address.state_id

Description

Used to indicate the State where the incident occurred.

Type

String

Required

false

Options
  • AA Armed Forces Americas (except Canada)
  • AE Armed Forces Africa, Canada, Europe, Middle East
  • AK Alaska
  • AL Alabama
  • AP Armed Forces Pacific
  • AR Arkansas
  • AS AMERICAN SAMOA
  • AZ Arizona
  • CA California
  • CO Colorado
  • CT Connecticut
  • DC District of Columbia
  • DE Delaware
  • FL Florida
  • FM FEDERATED STATES OF MICRONESIA
  • GA Georgia
  • GU Guam
  • HI Hawaii
  • IA Iowa
  • ID Idaho
  • IL Illinois
  • IN Indiana
  • KS Kansas
  • KY Kentucky
  • LA Louisiana
  • MA Massachusetts
  • MD Maryland
  • ME Maine
  • MH MARSHALL ISLANDS
  • MI Michigan
  • MN Minnesota
  • MO Missouri
  • MP NORTHERN MARIANA ISLANDS
  • MS Mississippi
  • MT Montana
  • NC North Carolina
  • ND North Dakota
  • NE Nebraska
  • NH New Hampshire
  • NJ New Jersey
  • NM New Mexico
  • NV Nevada
  • NY New York
  • OH Ohio
  • OK Oklahoma
  • OR Oregon
  • PA Pennsylvania
  • PR PUERTO RICO
  • PW PALAU
  • RI Rhode Island
  • SC South Carolina
  • SD South Dakota
  • TN Tennessee
  • TX Texas
  • UT Utah
  • VA Virginia
  • VI Virgin Islands
  • VT Vermont
  • WA Washington
  • WI Wisconsin
  • WV West Virginia
  • WY Wyoming

general_information.location.address.zip

Description

Used to indicate the zip code of where the incident occurred.

Type

String

Required

false

general_information.location.address.coords

Description

Used to indicate the coordinates where the incident occurred.

Type

Object

Required

false

general_information.location.address.coords.latitude

Description

Used to report the latitude in the NAD83 coordinate system of the address where the incident occurred.

Type

Number

Required

false

Validation
  • Value is a decimal with 4 places after the decimal point
  • Value can start with an optional negative sign
  • Value can have 1 to 2 digits before the decimal point
  • Value can be a number between -90.0000 and 90.0000

general_information.location.address.coords.longitude

Description

Used to report the longitude in the NAD83 coordinate system of the address where the incident occurred.

Type

Number

Required

false

Validation
  • Value is a decimal with 4 places after the decimal point
  • Value can start with an optional negative sign
  • Value can have 1 to 3 digits before the decimal point
  • Value can be a number between -180.0000 and 180.0000

general_information.location.location.type

Description

Used to indicate the type of location/premises where the Contact took place.

Type

String

Required

true

Options
  • Abandoned/Condemned Structure
  • Air/Bus/Train Terminal
  • Amusement Park
  • Arena/Stadium/Fairgrounds/Coliseum
  • ATM (Automated Teller Machine) Separate from Bank
  • Auto Dealership New/Used
  • Bank/Savings and Loan
  • Bar/Nightclub
  • Camp/Campground
  • Church/Synagogue/Temple/Mosque
  • Commercial/Office Building
  • Community Center
  • Construction Site
  • Convenience Store
  • Daycare Facility
  • Department/Discount Store
  • Dock/Wharf/Freight/Modal Terminal
  • Drug Store/Doctor’s Office/Hospital
  • Farm Facility
  • Field/Woods
  • Gambling Facility/Casino/Race Track
  • Government/Public Building
  • Grocery/Supermarket
  • Highway/Road/Alley/Street/Sidewalk
  • Hotel/Motel/Etc.
  • Industrial Site
  • Jail/Prison/Penitentiary/Corrections Facility
  • Lake/Waterway/Beach
  • Liquor Store
  • Military Installation
  • Park/Playground
  • Parking/Drop Lot/Garage
  • Rental Storage Facility
  • Residence/Home
  • Rest Area
  • Restaurant
  • School–College/University
  • School–Elementary/Secondary
  • Service/Gas Station
  • Shelter–Mission/Homeless
  • Shopping Mall
  • Specialty Store
  • Tribal Lands
  • Pending
  • Unknown
  • Other

general_information.was_use_of_force

Description

Used to indicate whether force was used or not during the contact.

Type

String

Required

true

Options
  • Yes
  • No

general_information.duration

Description

Used to indicate the time that the contact lasted in minutes.

Type

Number

Required

true

citizens

Description

List of citizens contacted.

Type

Array of Objects

Required

true

Validation
  • At least, there must be one contact.

citizens.perceived_information

Description

Used to indicate all the perceived characteristics of the citizens contacted.

Type

Object

Required

true

citizens.perceived_information.race_ethnicity

Description

Used to indicate the perceived race of the citizen by the reporting officer.

Type

String

Required

true

Options
  • American Indian or Alaskan Native
  • Asian
  • Black or African-American
  • Hispanic or Latino
  • Native Hawaiian or Other Pacific Islander
  • White

citizens.perceived_information.gender

Description

Used to indicate the perceived gender of the citizen by the reporting officer.

Type

String

Required

true

Options
  • Female
  • Male
  • Pending
  • Unknown

citizens.perceived_information.age

Description

Used to indicate the estimated age of the citizen by the reporting officer.

Type

Number

Required

true

citizens.perceived_information.height_ft

Description

Used to indicate the estimated height in feet of the citizen.

Type

Number

Required

false

citizens.perceived_information.height_in

Description

Used to indicate the estimated height in inches of the citizen.

Type

Number

Required
  • If citizens.perceived_information.height_ft is provided.
Validation
  • Cannot be provided if citizens.perceived_information.height_ft is not provided.

citizens.perceived_information.weight

Description

Used to indicate the estimated weight in pouds of the citizen.

Type

Number

Required

false

citizens.perceived_information.impairment

Description

Used to indicate if the Law Enforcement Officer felt the citizen had an apparent or known impairment in mental or physical condition.

Type

String

Required

true

Options
  • Yes
  • No
  • Pending
  • Unknown

citizens.perceived_information.impairment_type

Description

Used to indicate the impairment type of the citizen at the time of incident.

Type

Array of Strings

Required

true

Options
  • Alcohol Impairment
  • Drug Impairment
  • Mental Health Condition
  • Pending
  • Unknown

citizens.perceived_information.mental_crisis

Description

Used to indicate if the contacted citizen appears to be experiencing a mental crisis.

Type

String

Required

false

Options
  • Yes
  • No

citizens.incident_information

Description

Used to indicate all the incident information related to the citizen.

Type

Object

Required

true

citizens.incident_information.contact_reason

Description

Used to indicate the reason the citizen was contacted.

Type

String

Required

true

Options
  • Court Order
  • Follow Up Investigation
  • Mass Demonstration
  • Medical, Mental Health, or Welfare Assistance
  • Response to Unlawful or Suspicious Activity
  • Routine Patrol Other than Traffic Stop
  • Traffic Stop
  • Warrant Service
  • Pending
  • Unknown
  • Other

citizens.incident_information.nibrs.incident_number

Description

Used to indicate the National Incident-Based Reporting System of this incident.

Type

String

Required
  • If citizens.incident_information.contact_reason is "Response to Unlawful or Suspicious Activity"

citizens.incident_information.contact_violations

Description

Used to indicate all the violations that led to contact.

Type

Array of Strings

Required
  • If citizens.incident_information.contact_reason is "Traffic Stop"
Options
  • Driver's License Violation
  • Equipment Violation
  • Moving Violation
  • Parking Violation
  • Pedestrian Violation
  • Vehicle Insurance Violation

citizens.incident_information.information_collected_limited_to_driver

Description

Used to indicate all the information collected limited to driver.

Type

Array of Strings

Required
  • If citizens.incident_information.contact_reason is "Traffic Stop"
Options
  • Driver's License
  • ID Card
  • Passport
  • Proof of Insurance
  • Vehicle Registration
  • Verbal Identification
  • Other (limited to what driver produces for officer)

citizens.incident_information.traffic_infractions

Description

Used to indicate whether there ware traffic infractions.

Type

Array of Strings

Required
  • If citizens.incident_information.contact_reason is "Traffic Stop"
Options
  • Defective Vehicle
  • DUI
  • Improper/Reckless/Careless Driving
  • Lane Usage
  • Right of Way
  • Speed
  • Traffic Control Device
  • Other

citizens.incident_information.unannounced_entry

Description

Used to indicate whether there was an unannounced entry.

Type

String

Required
  • If citizens.incident_information.contact_reason is "Warrant Service"
Options
  • Yes
  • No

citizens.incident_information.no_person_present

Description

Used to indicate whether there was a person present during the entry.

Type

String

Required
  • If citizens.incident_information.contact_reason is "Warrant Service"
Options
  • Yes
  • No

citizens.incident_information.contact_other_reason

Description

Used to indicate other reasons why the citizen was contacted.

Type

Array of String

Required

false

Options
  • Consensual Contact
  • Eyewitness
  • Victim

citizens.incident_information.was_a_showup

Description

Used to indicate when a showup was performed.

Type

String

Required

false

Options
  • Yes
  • No

citizens.incident_information.showup_outcome

Description

Used to indicate the outcome of the showup.

Type

String

Required
  • if citizens.incident_information.was_a_showup is true
Options
  • Yes: Confident
  • Yes: Somewhat Confident
  • Yes: Not Confident
  • No

citizens.incident_information.contact_suspected_crimes

Description

Used to indicate all the crimes suspected per citizen.

Type

Array of Strings

Required

true

Options
  • Animal Cruelty
  • Arson
  • Assault Offenses - Aggravated Assault
  • Assault Offenses - Intimidation
  • Assault Offenses - Simple Assault
  • Bad Checks
  • Bribery
  • Burglary/Breaking & Entering
  • Counterfeiting/Forgery
  • Curfew/Loitering/Vagrancy Violations
  • Destruction/Damage/Vandalism of Property
  • Disorderly Conduct
  • Driving Under the Influence
  • Drug Equipment Violations
  • Drug/Narcotic Violations
  • Drunkenness
  • Embezzlement
  • Extortion/Blackmail
  • Family Offenses, Nonviolent
  • Fraud Offenses - Credit Card/Automated Teller Machine Fraud
  • Fraud Offenses - Hacking/Computer Invasion
  • Fraud Offenses - Identity Theft
  • Fraud Offenses - Impersonation
  • Fraud Offenses - Welfare Fraud
  • Fraud Offenses - Wire Fraud
  • Fraud Offenses - False Pretenses/Swindle/Confidence Game
  • Gambling Offenses - Betting/Wagering
  • Gambling Offenses - Gambling Equipment Violation
  • Gambling Offenses - Operating/Promoting/Assisting Gambling
  • Gambling Offenses - Sports Tampering
  • Homicide Offenses - Justifiable Homicide
  • Homicide Offenses - Murder & Non negligent Manslaughter
  • Homicide Offenses - Negligent Manslaughter
  • Human Trafficking, Commercial Sex Acts
  • Human Trafficking, Involuntary Servitude
  • Kidnapping/Abduction
  • Larceny/Theft Offenses - All Other Larceny
  • Larceny/Theft Offenses - Pocket-picking
  • Larceny/Theft Offenses - Purse-snatching
  • Larceny/Theft Offenses - Shoplifting
  • Larceny/Theft Offenses - Theft From Building
  • Larceny/Theft Offenses - Theft From Coin-Operated Machine or Device
  • Larceny/Theft Offenses - Theft From Motor Vehicle
  • Larceny/Theft Offenses - Theft of Motor Vehicle Parts or Accessories
  • Liquor Law Violations
  • Motor Vehicle Theft
  • Peeping Tom
  • Pornography/Obscene Material
  • Prostitution Offenses - Assisting or Promoting Prostitution
  • Prostitution Offenses - Prostitution
  • Prostitution Offenses - Purchasing Prostitution
  • Robbery
  • Sex Offenses - Fondling
  • Sex Offenses - Incest
  • Sex Offenses - Rape
  • Sex Offenses - Sexual Assault With An Object
  • Sex Offenses - Sodomy
  • Sex Offenses - Statutory Rape
  • Stolen Property Offenses
  • Trespass of Real Property
  • Weapon Law Violations
  • No Crime Suspected
  • All Other Offenses

citizens.incident_information.entry_made_into_a_residence

Description

Used to indicate whether an entry was made into a residence.

Type

String

Required

false

Options
  • Yes
  • No

citizens.incident_information.entry_forced

Description

Used to indicate whether the entry was forced.

Type

String

Required
  • If citizens.incident_information.entry_made_into_a_residence is true
Options
  • Yes
  • No

citizens.incident_information.warrant

Description

Used to indicate whether there was a warrant authorizing entry.

Type

String

Required
  • If citizens.incident_information.entry_made_into_a_residence is true
Options
  • Yes
  • No

citizens.incident_information.exhibited_weapon

Description

Used to indicate whether the citizen exhibited a weapon.

Type

String

Required

false

Options
  • Yes
  • No

citizens.incident_information.exhibited_weapon_type

Description

Used to indicate the type of weapon exhibited by the citizen.

Type

Array of Strings

Required
  • If citizens.incident_information.exhibited_weapon is true
Options
  • Dangerous Weapons (Knives, Blunt Objects, Projecticles, etc)
  • Firearm
  • Motor Vehicle/Vessel
  • Personal Weapons (Hands, Fist, Feet, etc)
  • All Others

citizens.incident_information.exhibited_weapon_when_was_discovered

Description

Used to indicate when the weapon was discovered.

Type

String

Required
  • If citizens.incident_information.exhibited_weapon is true
Options
  • After Use of Force
  • Before Use of Force
  • Force Not Used

use_of_force.citizens.resistance

Description

Used to indicate if the citizen resisted during the incident.

Type

String

Required

string

Options
  • Yes
  • No

use_of_force.citizens.resistance_type

Description

Used to indicate the resistance used by the citizen during the incident.

Type

Array of Strings

Required
  • If use_of_force.citizens.resistance is "Yes"
Options
  • Attempt to Escape/Flee from Custody
  • Barricading Self
  • Directing a Vehicle at an Officer or Another
  • Displaying a Weapon at an Officer or Another
  • Failing to Comply to Verbal Commands or Other Types of Passive Resistance
  • Intentionally Spitting or Bleeding on an Officer
  • Making Verbal Threats
  • Throwing an Article or Object at an Officer
  • Using a Firearm Against an Officer or Another
  • Using Another Weapon (such as chemical agent, edged weapons, electronic control weapon, or blunt object) Against an Officer or Another
  • Using Hands/Fists/Feet Against an Officer or Another

use_of_force.citizens.threat_directed_at

Description

Used to indicate who the threat by the citizen(s) was perceived by the officer(s) to be directed to, the officer or to another party.

Type

String

Required
  • If use_of_force.citizens.resistance is "Yes"
Options
  • Another Party
  • Both the Officer and Others
  • Officer
  • Pending
  • Unknown

citizens.incident_information.search_requested_permission

Description

Used to indicate whether there the officer requested permission to search.

Type

String

Required

false

Options
  • Yes
  • No

citizens.incident_information.search_granted_permission

Description

Used to indicate whether there the permission to search was granted by the citizen.

Type

String

Required

false

Options
  • Yes
  • No

citizens.incident_information.search

Description

Used to indicate whether there was a search conducted.

Type

String

Required

false

Options
  • Yes
  • No

citizens.incident_information.search_what

Description

Used to indicate what was searched.

Type

Array of Strings

Required
  • If citizens.incident_information.search is true
Options
  • Person
  • Property
  • Vehicle

citizens.incident_information.search_person_basis

Description

Used to indicate the basis for person search.

Type

String

Required
  • If citizens.incident_information.search_what contains "Person"
Options
  • Consent
  • Inventory
  • Search Warrant
  • Search Warrant Exception

citizens.incident_information.search_property_basis

Description

Used to indicate the basis for property search.

Type

String

Required
  • If citizens.incident_information.search_what contains "Property"
Options
  • Consent
  • Inventory
  • Search Warrant
  • Search Warrant Exception

citizens.incident_information.search_vehicle_basis

Description

Used to indicate the basis for vehicle search.

Type

String

Required
  • If citizens.incident_information.search_what contains "Vehicle"
Options
  • Consent
  • Inventory
  • Search Warrant
  • Search Warrant Exception

citizens.incident_information.search_contraband_or_evidence

Description

Used to indicate whether contraband or evidence was found.

Type

String

Required
  • If citizens.incident_information.search is true
Options
  • Yes
  • No

citizens.incident_information.action_taken

Description

Used to indicate the action taken by the reporting officer.

Type

Array of Strings

Required

true

Options
  • Arrest
  • Citation
  • Mental Health Transport
  • Property Seizure
  • Warning
  • No Action

citizens.incident_information.action_taken_crimes

Description

Used to indicate all the crimes committed by the citizen.

Type

Array of Strings

Required
  • If citizens.incident_information.action_taken contains "Arrest"
Options
  • Animal Cruelty
  • Arson
  • Assault Offenses - Aggravated Assault
  • Assault Offenses - Intimidation
  • Assault Offenses - Simple Assault
  • Bad Checks
  • Bribery
  • Burglary/Breaking & Entering
  • Counterfeiting/Forgery
  • Curfew/Loitering/Vagrancy Violations
  • Destruction/Damage/Vandalism of Property
  • Disorderly Conduct
  • Driving Under the Influence
  • Drug Equipment Violations
  • Drug/Narcotic Violations
  • Drunkenness
  • Embezzlement
  • Extortion/Blackmail
  • Family Offenses, Nonviolent
  • Fraud Offenses - Credit Card/Automated Teller Machine Fraud
  • Fraud Offenses - Hacking/Computer Invasion
  • Fraud Offenses - Identity Theft
  • Fraud Offenses - Impersonation
  • Fraud Offenses - Welfare Fraud
  • Fraud Offenses - Wire Fraud
  • Fraud Offenses - False Pretenses/Swindle/Confidence Game
  • Gambling Offenses - Betting/Wagering
  • Gambling Offenses - Gambling Equipment Violation
  • Gambling Offenses - Operating/Promoting/Assisting Gambling
  • Gambling Offenses - Sports Tampering
  • Homicide Offenses - Justifiable Homicide
  • Homicide Offenses - Murder & Non negligent Manslaughter
  • Homicide Offenses - Negligent Manslaughter
  • Human Trafficking, Commercial Sex Acts
  • Human Trafficking, Involuntary Servitude
  • Kidnapping/Abduction
  • Larceny/Theft Offenses - All Other Larceny
  • Larceny/Theft Offenses - Pocket-picking
  • Larceny/Theft Offenses - Purse-snatching
  • Larceny/Theft Offenses - Shoplifting
  • Larceny/Theft Offenses - Theft From Building
  • Larceny/Theft Offenses - Theft From Coin-Operated Machine or Device
  • Larceny/Theft Offenses - Theft From Motor Vehicle
  • Larceny/Theft Offenses - Theft of Motor Vehicle Parts or Accessories
  • Liquor Law Violations
  • Motor Vehicle Theft
  • Peeping Tom
  • Pornography/Obscene Material
  • Prostitution Offenses - Assisting or Promoting Prostitution
  • Prostitution Offenses - Prostitution
  • Prostitution Offenses - Purchasing Prostitution
  • Robbery
  • Sex Offenses - Fondling
  • Sex Offenses - Incest
  • Sex Offenses - Rape
  • Sex Offenses - Sexual Assault With An Object
  • Sex Offenses - Sodomy
  • Sex Offenses - Statutory Rape
  • Stolen Property Offenses
  • Trespass of Real Property
  • Weapon Law Violations
  • No Crime Suspected
  • All Other Offenses

citizens.incident_information.action_taken_violations_cited

Description

Used to indicate what violations were cited.

Type

Array of Strings

Required

false

Options
  • Criminal Offense
  • Driver's License Violation
  • Vehicle Insurance Violation
  • Equipment Violation
  • Moving Violation
  • Municipal Code or Petty Offense
  • Parking Violation
  • Pedestrian Violation

citizens.incident_information.seized_type

Description

Used to indicate what type of property was seized.

Type

Array of Strings

Required
  • If citizens.incident_information.action_taken contains "Property Seizure"
Options
  • Currency
  • Clothing / Footwear
  • Documents
  • Drugs
  • Firearm Weapons
  • Non-firearm Weapons
  • Phones / Computers / Electronics
  • Vehicle / Vehicle Parts
  • Other

citizens.incident_information.seized_basis

Description

Used to indicate basis for seizing property.

Type

Array of Strings

Required
  • If citizens.incident_information.action_taken contains "Property Seizure"
Options
  • Contraband
  • Evidence
  • Safekeeping

citizens.incident_information.action_taken_violations_warned

Description

Used to indicate what violations were warned.

Type

Array of Strings

Required

false

Options
  • Criminal Violation
  • Driver's License Violation
  • Equipment Violation
  • Moving Violation
  • Parking Violation
  • Pedestrian Violation
  • Vehicle Insurance Violation

citizens.incident_information.injured

Description

Used to indicate whether the citizen was injured (serious or minor) during the incident.

Type

String

Required

false

Options
  • Yes
  • No

citizens.incident_information.injuries

Description

Used to indicate the type of injuries sustained by the citizen.

Type

Array of Strings

Required
  • If ccitizens.incident_information.injured is "Yes"
Options
  • Death
  • Gunshot Wound (including minor or grazing wounds)
  • Serious Injury Requiring Medical Intervention or Hospitalization
  • Unconsciousness (regardless of duration)
  • Pending
  • Unknown
  • Other apparent Minor Injuries
Validation
  • If “Death” is provided, no other values can be provided for the citizen.
  • If “Pending” is provided, no other values can be provided for the citizen.
  • If “Unknown” is provided, no other values can be provided for the citizen.

citizens.incident_information.force_type_used_by_officer

Description

Used to indicate the type of force used by the officer(s) on the citizen during the incident.

Type

Array of Strings

Required
  • If ccitizens.incident_information.injured is "Yes"
Options
  • Baton
  • Blunt Instrument/Flashlight
  • Canine
  • Chemical Agent/Pepper or OC (oleoresin capsicum) Spray
  • Electronic Control Weapon (Taser®)
  • Explosive Device
  • Firearm
  • Hands-fists-feet
  • Impact Projectile
  • Pending
  • Unknown
  • Other

citizens.incident_information.ambulance_called_to_scene

Description

Used to indicate whether the ambulance was called to the scene.

Type

String

Required

false

Options
  • Yes
  • No

citizens.incident_information.transported_to_hospital

Description

Used to indicate whether the citizen was transported to the hospital.

Type

String

Required

false

Options
  • Yes
  • No

use_of_force

Description

Used to indicate the information related to the Use of Force of this contact.

Type

Object

Required
  • If general_information.was_use_of_force is true

use_of_force.agency.case_number

Description

Used to indicate the agency’s case number for the Use-of-Force incident.

Type

String

Required

true

Validation
  • Can only contain letters, numbers and hyphens (-).
  • Maximum length supported is twenty (20) characters.
Validation
  • Only one value can be provided for an incident
  • Maximum length is 20 characters
  • The only special character allowed is a hyphen

use_of_force.severity

Description

Used to indicate if the incident resulted in a death or serious bodily injury due to law enforcement use-of-force, or if there was a discharge of a firearm by a law enforcement officer at or in the direction of a person.

Type

Array of Strings

Required

false

Options
  • Death (The death of a person due to law enforcement use-of-force)
  • Discharge of Firearm (The discharge of a firearm by law enforcement at or in the direction of a person)
  • Serious Bodily Injury (The serious bodily injury of a person due to law enforcement use-of-force)

use_of_force.did_officer_approach

Description

Used to indicate if the law enforcement official approached the citizen

Type

String

Required

true

Options
  • Yes
  • No

use_of_force.senior_officer_present

Description

Used to indicate if a supervisor or senior officer acting in a similar capacity was present or consulted prior to when force was used during the incident.

Type

String

Required

true

Options
  • Yes
  • No

use_of_force.ambushed

Description

Used to indicate if the incident involved an ambush of a law enforcement official.

Type

String

Required
  • Yes
  • No

use_of_force.other_agencies_involved.agency_information.agency_ori

Description

Used to identify the ORI number of every agency involved.

Type

String

Required

false

use_of_force.other_agencies_involved.agency_information.agency_case_number

Description

Used to indicate the other agency’s case number for the Use-of-Force incident.

Type

String

Required
  • If use_of_force.other_agencies_involved.agency_information.agency_ori is provided.

use_of_force.officers

Description

Used to provide the officer(s) data for the Use-of-Force Incident.

Type

Array of Objects

Required

true

use_of_force.officers.officer_information.officer_post_number

Description

Used to indicate the Peace Officer Standards & Training number.

Type

String

Required

false

use_of_force.officers.officer_information.race_ethnicity

Description

Used to indicate the race of the officer.

Type

String

Required

false

Options
  • American Indian or Alaskan Native
  • Asian
  • Black or African-American
  • Hispanic or Latino
  • Native Hawaiian or Other Pacific Islander
  • White

use_of_force.officers.officer_information.gender

Description

Used to indicate the gender of the officer.

Type

String

Required

true

Options
  • Female
  • Male
  • Pending
  • Unknown

use_of_force.officers.officer_information.age

Description

Used to indicate the age of the officer.

Type

Number

Required

false

use_of_force.officers.officer_information.height_ft

Description

Used to indicate the height of the officer in feet.

Type

Number

Required

false

use_of_force.officers.officer_information.height_in

Description

Used to indicate the height of the officer in inches.

Type

Number

Required
  • If use_of_force.officers.officer_information.height_ft is provided.
Validation
  • Cannot be provided if use_of_force.officers.officer_information.height_ft is not provided.

use_of_force.officers.officer_information.weight

Description

Used to indicate the weight of the officer.

Type

Number

Required

false

use_of_force.officers.officer_information.years_of_service

Description

Used to indicate the officer's number of years of service.

Type

Number

Required

false

use_of_force.officers.officer_information.full_part_time

Description

Used to indicate if officer is employed full or part time.

Type

String

Required

true

Options
  • Yes
  • No

use_of_force.officers.incident_information.primary_officer

Description

Used to indicate if the officer was the primary officer of the incident.

Type

String

Required

true

Options
  • Yes
  • No

use_of_force.officers.incident_information.on_duty

Description

Used to indicate if the officer was on duty at time of incident.

Type

String

Required

true

Options
  • Yes
  • No

use_of_force.officers.incident_information.identifiable

Description

Used to indicate if the officer was readily identifiable as an officer during the incident.

Type

String

Required

true

Options
  • Yes
  • No

use_of_force.officers.incident_information.weapon_brandished

Description

Used to indicate whether any weapon was brandished by the officer.

Type

String

Required

false

Options
  • Yes
  • No

use_of_force.officers.incident_information.weapon_brandished_type

Description

Used to indicate the types of weapon brandished by the officer.

Type

Array of Strings

Required
  • If use_of_force.officers.incident_information.weapon_brandished is "Yes"
Options
  • Baton
  • Firearm
  • Long Gun
  • Nunchucks
  • OC Spray
  • Projectile Weapon
  • Taser

use_of_force.officers.incident_information.weapon_discharged

Description

Used to indicate whether any weapon was discharged during the contact by the officer.

Type

String

Required

false

Options
  • Yes
  • No

use_of_force.officers.incident_information.weapon_discharged_type

Description

Used to indicate the types of weapons discharged during the contact by the officer.

Type

Array of Strings

Required
  • If use_of_force.officers.incident_information.weapon_discharged is "Yes"
Options
  • Firearm
  • Long Gun
  • Projectile Weapon
  • Taser

use_of_force.officers.incident_information.injured

Description

Used to indicate whether the officer was injured (serious or minor) during the incident.

Type

String

Required

false

Options
  • Yes
  • No

use_of_force.officers.incident_information.injuries

Description

Used to indicate the injuries of the officer.

Type

Array of String

Required

If use_of_force.officers.incident_information.injured is "Yes"

Options
  • Death
  • Gunshot Wound (including minor or grazing wounds)
  • Serious Injury Requiring Medical Intervention or Hospitalization
  • Unconsciousness
  • Pending
  • Unknown
  • Other apparent Minor Injuries

use_of_force.officers.incident_information.nibrs_incident_number

Description

Used when an officer incurs injuries during the incident. The NIBRS (or local) incident number relating to the report detailing the assault or homicide of the law enforcement officer.

Type

String

Required
  • If use_of_force.officers.incident_information.injured is “Yes”
Validation
  • Maximum length is 20 characters
  • The only special character allowed is a hyphen

use_of_force.officers.incident_information.ambulance_called_to_scene

Description

Used to indicate whether the ambulance was called to the scene.

Type

String

Required

false

Options
  • Yes
  • No

use_of_force.officers.incident_informationtransported_to_hospital

Description

Used to indicate whether the officer was transported to the hospital.

Type

String

Required

false

Options
  • Yes
  • No

use_of_force.officers.incident_information.investigation

Description

Used to indicate if an investigation was opened based on this case for this officer.

Type

String

Required

false

Options
  • Yes
  • No

use_of_force.officers.incident_information.investigation_outcome

Description

Used to indicate the outcome of the investigation.

Type

String

Required

If uuse_of_force.officers.incident_information.investigation is "Yes"

Options
  • Sustained
  • Not Sustained
  • Unfounded
  • Exonerated
  • Closed
  • Under Investigation
  • Charges Filed

complaints

Description

Used to indicate the complaits related to the contact.

Type

Array of Objects

Required

false

complaints.complaints_information.outcome

Description

Used to indicate the information related to the Complaints connected to this contact.

Type

Array of Strings

Required
  • If complaints.complaints_information is provided
Options
  • Closed
  • Exonerated
  • Not Sustained
  • Sustained
  • Under Investigation
  • Unfounded
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment