US Quality Core Implementation Guide
0.1.0 - cibuild United States of America flag

US Quality Core Implementation Guide, published by ASTP. This guide is not an authorized publication; it is the continuous build for version 0.1.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/FHIR/us-quality-core/ and changes regularly. See the Directory of published versions

US Quality Core Implementation Guide

Official URL: http://fhir.org/guides/astp/us-quality-core/ImplementationGuide/us-quality-core Version: 0.1.0
Active as of 2026-03-31 Computable Name: USQualityCore

Disclaimer:

This Implementation Guide (IG) is not an update to health IT certification criteria or processes regulated by the Assistant Secretary for Technology Policy (ASTP)/ Office of the National Coordinator for Health Information Technology (ONC) (collectively, ASTP/ONC). Readers should monitor final rules provided by programs such as the Centers for Medicare & Medicaid Services (CMS) and/or ASTP for information on official updates to the health IT certification process and measure submission requirements for quality programs.

Summary

The US Quality Core Implementation Guide provides guidance for implementing USCDI+ Quality in FHIR to support consistent, interoperable representation and exchange of quality data for quality measurement and reporting programs. It defines profiles that derive from and extend the base FHIR version R4 resources and US Core profiles to provide a common foundation for implementing, sharing, and evaluating quality-related knowledge artifacts across quality improvement efforts. It also defines basic system capability expectations for exchanging data to support digital quality measurement and reporting over standard FHIR interfaces.

Background

This guide reflects a coordinated federal effort to enable standardized FHIR-based exchange of data for digital quality measurement and reporting. ASTP/ONC has established the USCDI+ Quality data element list as a common, reusable foundation that can support quality measurement across programs and settings over time, with a transparent process for proposing and considering additional data elements in future versions. This guide specifies how to represent and exchange the USCDI+ Quality data elements as needed to support reporting of electronic clinical quality measures (eCQMs) used in certain CMS quality reporting programs, as well as providing guidance on additional data elements used in other quality reporting programs. For more detail on USCDI+ Quality and its scope, see the USCDI+ Quality page in this guide.

This guide descends directly from the Quality Improvement Core (QI-Core) Implementation Guide, which aligns with the standards adopted for the ONC Health IT Certification Program, including FHIR, US Core, and USCDI. The initial version of this guide targets USCDI+ Quality V1 data elements. It is based on the QI-Core Implementation Guide v6.0.0 (QI-Core 6.0.0), which aligns with the US Core Implementation Guide v6.1.0 (US Core 6.1.0) and USCDI v3.1.1

This guide extends QI-Core by providing USCDI+ Quality guidance within profiles through the use of flags for USCDI+ Quality relevant elements. It also introduces CapabilityStatements that define specific expectations for actors exchanging US Quality Core data over standard RESTful FHIR interfaces. The technical content in this initial version of US Quality Core is intended to be backward compatible with QI-Core 6.0.0. Details of the specific changes made from QI-Core 6.0.0 are provided in the Change Log.

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: This page provides a summary, background, and scope of US Quality Core.
  • Conformance: These pages describe the set of rules to claim conformance to this guide.
    • General Requirements: This page defines requirements common to all profiles used in this guide.
    • Must Support: This page defines the expectations for mandatory, Must Support, and USCDI+Quality flagged elements in the US Quality Core Profiles.
    • Security: This page documents the general security requirements.
  • Guidance: These pages document best practices and how to use the profiles defined in this guide.
    • USCDI+ Quality: This page provides additional information about the relationship between USCDI+ Quality and US Quality Core. It maps the US Quality Core Profiles to the USCDI+ Quality data classes and data elements.
    • General Guidance: This page provides guidance and requirements common to all profiles used in this guide.
    • US Quality Core Negation: This page provides guidance on using US Quality Core negation profiles.
    • Provenance: This page describes the use of Provenance for this guide.
    • Relationship with USCore and QI-Core: This page describes the US Quality Core relationship with US-Core and QI-Core.
    • QDM-to-US Quality Core Mapping: This page provides a detailed description of mapping from the Quality Data Model (QDM) to US Quality Core.
  • FHIR Artifacts: These pages provide detailed descriptions and formal definitions for all the FHIR objects defined in this guide.
    • Capability Statements: This page defines the expected FHIR capabilities of the US Quality Core Servers and Clients.
    • Profiles: This page lists all profiles defined in or used by US Quality Core.
    • Extensions: This page lists all extensions defined as part of US Quality Core.
    • Terminology: This page lists the US Quality Core ValueSets and Code Systems defined for the profiles.
    • Examples: This page lists all the examples used in this guide.
  • CQL Artifacts and Patterns: These pages provide the US Quality Core model information (ModelInfo) and document patterns for use with US Quality Core.
    • US Quality Core ModelInfo: This page provides the US Quality Core model information to support implementation using Clinical Quality Language (CQL).
    • US Quality Core Patterns: This page describes patterns of usage for US Quality Core applications.
  • Downloads: This page provides links to downloadable artifacts.
  • Change Log: This Change Log lists changes from QI-Core 6.0.0 to this guide.

Scope

The US Quality Core IG provides requirements and guidance for using FHIR to implement the USCDI+ Quality data elements. The scope of the conformance expectations of this version of the guide is limited to the representation and exchange of data described in USCDI+ Quality V1. Note that not all USCDI+ Quality V1 data elements are in scope for this version's conformance requirements. See the In-Scope USCDI+ Quality Data Elements section for a complete list of the USCDI+ Quality V1 data elements that are in scope for the conformance requirements of this guide.

The scope of this guide is limited to the published content of QI-Core 6.0.0 and US Core 6.1.0.

USCDI+ Quality V1 data elements that are not readily represented in the profiles provided by QI-Core 6.0.0 or US Core 6.1.0 are outside the scope of this version of the guide. Implementers are encouraged to provide feedback for inclusion in future versions of this guide.

This guide retains all artifacts provided by QI-Core 6.0.0, with limited alterations described below, to support the adoption by existing QI-Core implementers. The US Quality Core profiles adhere to a naming convention that uses the prefix "US Quality Core". For example, the US Quality Core profile of Patient is named US Quality Core Patient.

These limited FHIR artifact changes made in this guide include:

  • Updated the prefix of FHIR profile names from QI-Core to US Quality Core.
  • Updated logical id of the resources from 'qicore' to 'us-quality-core'.
  • Removed 'QI-Core' flags on FHIR elements, this guide uses 'USCDI+ Quality' flags to indicate which elements must be supported to meet USCDI+ Quality conformance requirements.
    • In cases where a 'QI-Core' flagged FHIR element within a QI-Core 6.0.0 profile does not map to a USCDI+ Quality data element, the FHIR element is not flagged and is therefore not part of the conformance requirements of this guide.

Note that the ModelInfo file that supports implementations using CQL has been updated to reflect the changes made to US Quality Core.

Acknowledgements

Content in this initial version of the US Quality Core is primarily based on the QI-Core 6.0.0, as managed by the HL7 Clinical Quality Information Workgroup and the supporting Quality Improvement (QI) community.


Footnotes:

  1. Consistent with Executive Order 14168 the Sex, Sexual Orientation, and Gender Identity, data elements have been removed or updated in the Patient Demographics/Information Data Class.