Vital Records Common Library (VRCL) STU2-ballot
2.0.0 - trial-use United States of America flag

Vital Records Common Library (VRCL) STU2-ballot, published by HL7 International / Public Health. This guide is not an authorized publication; it is the continuous build for version 2.0.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of and changes regularly. See the Directory of published versions


Official URL: Version: 2.0.0
Active as of 2024-07-19 Computable Name: VitalRecordsCommonLibrary


This guide is a FHIR Resources (FHIR) Library to support the needs of multiple Vital Records Implementation Guides (IGs) as well as the needs of related IGs. It does not provide any use case or scenario specific content or additional guidance on how to use these artifacts, but serves as a source for a standard set of profiles, extensions, codesystems and valuesets for reuse in multiple use case specific implementation guides focusing on the exchange of Vital Records information. Implementation details such as how and when to use a given artifact will be supplied in these guides.


The initial development of the STU1 version of this IG was motivated by the opportunity for reuse between the Birth and Fetal Death Reporting (BFDR) and Birth Defects Reporting (BDR) IGs. Following publication of STU1 versions of BFDR and Medicolegal and Death Investigation (MDI), an STU2 version of Vital Records Death Reporting (VRDR) , we have taken a broader view of reuse within these IGs as well as the anticipated needs of the as-yet unballoted BDR to develop the STU2 content for this IG. This process is described in Vital Records IG Harmonization.

Many of the profiles previously included to support BDR have been moved to the companion STU2 version of BFDR, and the content of this IG has been focused on FHIR resources that were redundantly defined across BFDR, VRDR and MDI, representing the vital records approach to common data elements. VRDR is the most mature of the vital records related FHIR IGs, having already moved into production usage by several jurisdictions and NCHS, and some of the patterns for FHIR implementation that were defined in the VRDR IG have been incorporated in the STU2 version of VRCL, and its companion STU2 version of BFDR. These patterns include definition of codesystems and valuesets within this IG, in lieu of reference to Public Health Information Network Vocabulary Access and Distribution System (PHIN VADS), support for “edit flags” within existing profiles, in lieu of additional companion Observation profiles, and standardized extensions for partial dates and times, and coded components of addresses.

This profile library will provide a standard framework for inclusion by reference in multiple use case specific IGs (i.e., BFDR, BDR, VRDR, MDI) to support interoperability among public health systems and reduce provider and implementer burden, and to streamline maintenance of the IGs.

How to Read This Guide

This Guide is divided into several pages which are listed at the top of each page in the menu bar.

  • Home: provides the introduction and background for this I
  • Artifacts: provides a list of the FHIR artifacts (profiles, examples, and value sets) defined as part of this guide.
  • Specification: provides general information about the FHIR specification
  • Usage: provides notes that are referenced by resources in this IG, and their uses in other IGs.
  • Change Log: provides a change history
  • STU1.1 to STU2 Changes: shows the provenance of all resources included in the STU2 version of this IG, as well as all of the disposition of the resources no longer included in this IG.
  • Downloads: provides links to downloadable artifacts.


Name Email/URL
HL7 International - Public Health