Violent Death and Overdose Reporting (VDOR) FHIR Implementation Guide
0.1.0-cibuild - CI Build United States of America flag

Violent Death and Overdose Reporting (VDOR) FHIR Implementation Guide, published by HL7 International / Public Health. This guide is not an authorized publication; it is the continuous build for version 0.1.0-cibuild built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/fhir-vdor/ and changes regularly. See the Directory of published versions

Artifacts Summary

This page provides a list of the FHIR artifacts defined as part of this implementation guide.

Core Profiles

Core profiles such as Bundle, Composition, and Patient.

VDOR Composition Profile

Defines constraints to the Composition resource in order to package VDOR related data elements as FHIR into a single document. This profile includes elements and extensions to support the NVDRS and SUDORS platform.

VDOR Decedent

Defines constraints on the VRDR Decedent profile to address the needs of VDRS data.

VDOR Document Bundle Profile

Defines constraints to the Bundle resource in order to package VDOR (e.g. NVDRS and SUDORS) related data elements as FHIR into a single document.

Toxicology Summary Profiles

Profiles in the Toxicology category related to the Toxicology Summary section.

VDOR Toxicology Summary - Alcohol Tested Observation

Defines constraints on the Observation resource to represent the set of Toxicology Summary section of SUDORS.

VDOR Toxicology Summary Carbon Monoxide Tested Observation

Defines constraints on the Observation resource to represent the set of Toxicology Summary section of SUDORS.

VDOR Toxicology Summary Observation

Defines constraints on the Observation resource to represent the set of Toxicology Summary section of SUDORS.

Circumstances Profiles

Profiles in the Circumstances category.

VDOR Circumstances - Abuse or Neglect Led to Death (Death Abuse)

Defines constraints on the Observation resource to capture whether or not abuse or neglect led to death (Death Abuse).

VDOR Circumstances - Circumstances Category Observation

Defines constraints on the Observation resource to capture items in the Circumstances category. This is a parent profile.

VDOR Circumstances - Current Depressed Mood

Defines constraints on the Observation resource to capture whether or not the decedent was depressed at or around death.

VDOR Circumstances - Drive-by Shooting

Victim was killed in shooting where the suspect or group of suspects drives near the victim or target and shoots while driving or uses a car to approach and flee the scene of a homicide but steps out of the car just long enough to use a weapon.

VDOR Circumstances - Gang Related

Defines constraints on the Observation resource to capture whether or not the death was gang related.

VDOR Circumstances - History of Alcohol Use (Alcohol Problem)

Defines constraints on the Observation resource to capture whether or not the decedent has a history of alcohol use (alcohol problem).

Decedent Demographics Profiles

Profiles in the Demographics category.

VDOR Demographics - Demographics Category Observation

Defines constraints on the Observation resource to capture items in the Demographics category. This is a parent profile.

VDOR Demographics - Demographics Social History Category Observation

Defines constraints on the Observation resource to capture social history related items in the Demographics category. This is a parent profile based on the US Core Social History profile.

Weapons Profiles

Profiles in the Weapons category.

VDOR Weapons - Firearm

Defines constraints on the Observation resource to capture information on a Firearm for VDRS records.

VDOR Weapons - Weapon Type

Defines constraints on the Observation resource to capture information on weapon type

VDOR Weapons - Weapons Category Observation

Defines constraints on the Observation resource to capture items in the Weapon(s) category. This is a parent profile.

Overdose Profiles

Profiles in the Overdose category.

VDOR Overdose - Bystander(s) Present

Defines constraints on the Observation resource to represent an Overdose profile.

VDOR Overdose - Current or Past Prescription Drug Misuse or Illicit Drug Use

Defines constraints on the Observation resource to represent an Overdose profile.

VDOR Overdose - Evidence of Drug Use

Defines constraints on the Observation resource to represent an Overdose profile.

VDOR Overdose - Previous Overdose

Defines constraints on the Observation resource to represent an Overdose profile.

VDOR Overdose - Recent Emergency Department Visit or Urgent Care Visit

Defines constraints on the Observation resource to represent an Overdose profile.

VDOR Overdose - Recent Opiod Use Relapse

Defines constraints on the Observation resource to represent an Overdose profile.

VDOR Overdose - Time/Date First Found Unresponsive

Defines constraints on the Observation resource to represent an Overdose profile.

VDOR Overdose - Time/Date Last Known Alive and Well Pre-overdose

Defines constraints on the Observation resource to represent an Overdose profile.

VDOR Overdose - Treatment For Substance Use Disorder

Defines constraints on the Observation resource to represent an Overdose profile.

VDOR Overdose - Type of Overdose/poisoning

Defines constraints on the Observation resource to represent an Overdose profile.

VDOR Overdose - Use of Prescription Morphine

Defines constraints on the Observation resource to represent an Overdose profile.

NVDRS Extensions

Extensions for management of records in the NVDRS/SUDORS platform.

NVDRS Force New Record Extension

Boolean value to force a new record on import. NVDRS/SUDORS only.

NVDRS Incident Year Extension

Extension to support NVDRS incident year.

VDOR - NVDRS Overwrite Conflicts Extension

Boolean value to overwrite conflicts on import. NVDRS/SUDORS only.

Structures: Resource Profiles

These define constraints on FHIR resources for systems conforming to this implementation guide.

VDOR Injury and Death - EMS at Scene

Emergency medical services (EMS) were at the scene of the injury incident.

VDOR Injury and Death - Injury and Death Category Observation

Defines constraints on the Observation resource to capture items in the Injury and Death category. This is a parent profile.

VDOR Injury and Death - Number of Bullets

Number of bullets that hit the victim.

VDOR Overdose - Overdose Category Observation

Defines constraints on the Observation resource to capture items in the Overdose category. This is a parent profile.

VDOR Suspect(s) - Suspect(s) Category Observation

Defines constraints on the Observation resource to capture items in the Suspect(s) category. This is a parent profile.

Structures: Extension Definitions

These define constraints on FHIR data types for systems conforming to this implementation guide.

Identifier Extension

Extension to support additional identifiers.

VDOR Extension - Drug Misuse

Extension for Drug Misuse.

VDOR Extension - Types of Substance Use Disorder Treatments

Extension for Types of Substance Use Disorder Treatments.

VDOR Firearm Owner Extension

Defines an extension for the Firearm profile to capture information related to the Firearm's owner.

VDOR Firearm Serial Number

Defines an extension for the Firearm profile to capture firearm serial number information.

VDOR Firearm Stolen Extension

Defines an extension for the Firearm profile to capture information on if the firearm was stolen.

VDOR Firearm Stored Loaded Extension

Defines an extension for the Firearm profile to capture information if the firearm was stored loaded.

VDOR Firearm Stored Locked Extension

Defines an extension for the Firearm profile to capture information if the firearm was stored locked.

Terminology: Value Sets

These define sets of codes used by systems conforming to this implementation guide.

NVDRS Document Types

Import Record Document Types

NVDRS Weapon Type Valueset

Official NVDRS Coding Manual Weapon Type code ValueSet.

VDOR - NCIC Firearm Make Code

Sample valueset capturing a small set of NCIC codes.

VDOR - NVDRS Coding Manual Gang Related Codes Value Set

NVDRS Coding Manual values for Gun Owner.

VDOR - NVDRS Coding Manual Gun Owner Codes Value Set

NVDRS Coding Manual values for Gun Owner.

VDOR - NVDRS Firearm Model Code

Sample valueset capturing a small set of NVDRS Firearm Model codes.

VDOR - NVDRS Firearm Type Valueset

NVDRS Coding Manual values for Weapon Type.

VDOR - NVDRS Wound Location Response Options Observation Codes

Official NVDRS Coding Manual Wound Location Response Options code ValueSet.

VDOR Bystander(s) Present

Bystander(s) Present values.

VDOR Indicated Prescription Drug Misuse or Illicit Drug Use

Indicated prescription drugs misused or illicit drugs used values.

VDOR Previous Overdose

Previous Overdose values.

VDOR Previous Overdose Timing

Previous Overdose Timing values.

VDOR Recent Emergency Department Visit or Urgent Care Visit

Recent Emergency Department Visit or Urgent Care Visit values.

VDOR Recent Opioid Use Relapse

Type of Overdose values.

VDOR Tox Summary Carbon Monoxide Source

Tox Summary Carbon Monoxide source codes.

VDOR Tox Summary Test Results

Tox Summary profile results codes.

VDOR Tox Summary Tested

Tox Summary profile tested or not tested codes.

VDOR Toxicology Summary Tests Value Set

Observation codes for tests captured as part of the SUDORS Toxicology Summary.

VDOR Treatment for Substance Use Disorder

Treatment For Substance Use Disorder values.

VDOR Type of Overdose

Type of Overdose values.

VDOR Types of Treatment for Substance Use Disorder

Types of Treatment For Substance Use Disorder values.

VDOR Use of Prescription Morphine

Use of Prescription Morphine values.

VDOR Violent Death - Circumstances Category Value Set

Observation codes that fall under the Violent Death Circumstances Category.

VDOR Violent Death - Weapons Category Value Set

Observation codes that fall under the Violent Death Weapons(s) Category.

VDOR Violent Death - Wound Location Observation Codes

Observation codes representing wound location data elements. Aligned with the NVDRS schema.

Terminology: Code Systems

These define new code systems used by systems conforming to this implementation guide.

NCIC (National Crime Information Center) Gun Data Codes

Code system defined for use in the VDOR IG artifacts, capturing the NCIC Gun Data Codes.

NVDRS Firearm Model Codes

Code system defined for use in the VDOR IG artifacts, capturing the NVDRS Firearm Model Codes. Note: This is not found in the NVDRS Coding Manual.

VDOR - NVDRS Coding Manual Codes

Code system defined for use in the VDOR IG artifacts based on the NVDRS Coding Manual.

VDOR Implementation Guide Custom Defined Codes

Code system defined for use in VDOR Implementation Guide artifacts.

Example: Example Instances

These are example instances that show what data produced and consumed by systems conforming with this implementation guide might look like.

US Core Patient - Alice J. Freeman

Example of US Core Patient - Alice J. Freeman, decedent

VDOR Document
VDOR-Current-Or-Past-Drug-Misuse-Example-01

Current or Past Drug Misuse - Example 01 - No indicated drug misuse.

VDOR-Current-Or-Past-Drug-Misuse-Example-02

Current or Past Drug Misuse - Example 02 - Multiple indicated drugs.

VDOR-Treatment-For-Substance-Use-Disorder-Example-01

Treatment for Substance Use Disorder - Example 01 - Multiple treatments.