Migrating to V2 FAQ
Clone this wiki locally
Frequently Asked Questions about the V2 API transition for:
Blue Button 2.0 API (BB2.0)
Beneficiary Claims Data API (BCDA)
Data at the Point of Care (DPC)
Medicare Claims Data to Part D Sponsors API (AB2D)
BB2.0, BCDA, DPC, and AB2D will each create a version 2 of their APIs (collectively, “V2”).
V2 will conform to the FHIR R4 specification and follow the CARIN Implementation Guide for industry alliance. V2 will also make integration and interoperability with all our APIs seamless by enabling them to provide FHIR R4 validated and conformant resources for Patient, Coverage, and Explanation Of Benefits (EOB's). You can view our RFC on the Beneficiary FHIR Data Server's (BFD) Github repository for more information. (The BFD is a standards-based FHIR API that supports BB2.0, BCDA, DPC, and AB2D.)
In this new version, data about beneficiary claims and coverage will continue to flow smoothly to the partners who rely on it, in alignment with HL7 standards.
We are currently working on a detailed breakdown of the differences between V1 and V2 for the APIs. We’ll let you know in the Google Group when we publish that information.
FHIR R4 is a normative (stable) release of the standard. Normative releases have gone through a tremendous amount of oversight from the HL7/FHIR community.
If you are curious about the differences between FHIR versions, like “STU3” versus R4, more information can be found in the FHIR maturity model.
Because FHIR is a broad standard that covers many different applications, there is a long list of technical differences between R3 and R4 of FHIR, ranging from new fields to changed items to differences in requirements around certain items. It is important to understand that not all of those changes apply to the BB2.0, BCDA, DPC, or AB2D APIs.
The Interoperability and Patient Access final rule, published May 1, 2020, requires CMS-regulated payers to implement and maintain a secure, standards-based Patient Access API using HL7 FHIR 4.0.1 that allows patients to easily access their claims and encounter information through third-party applications of their choice. In concert with this requirement, CMS is currently developing a V2 of available APIs conformant with FHIR R4.
We have no plans to remove V1 in the foreseeable future. After V2 is launched in production, we will not add any new features or enhancements to the V1 endpoints. Our support will only cover what is necessary to maintain V1 at its current level of service.
Upgrading to CMS’s V2 API, which is conformant to FHIR R4 and the CARIN Alliance Blue Button® Framework and Common Payer Consumer Data Set (CPCDS) IG, ensures your product is aligned with the latest industry standards. Our V2 API will also be compatible with APIs from many other payers allowing your product to easily serve enrollees for those payers.
Additionally, the V2 API will ensure alignment across HHS interoperability efforts. For instance, if your organization is a CMS-regulated payer you will need to implement your own Patient Access API using FHIR R4 by July 2021. And, all CEHRT users will need to be conformant with FHIR R4 to meet the ONC regulations on updates to the 2015 CEHRT in the coming years. While V2 will be conformant with FHIR R4, V1 will not be.
Although we will maintain V1 and V2 in parallel for the foreseeable future, after V2 is launched in production, we will stop adding new features or enhancements to the V1 endpoints. Our support for V1 will only cover what is necessary to maintain V1 at its current level of service, meaning any additional fields or feature enhancements will only be added to V2 once it is launched in production.
The first step is to test the V2 data load to make sure it works with your existing application by replacing your existing URL endpoints with the new V2 endpoints when they are available in the sandbox. Send us any feedback about your experience, especially if any breaking changes cause issues in your application. You can provide feedback by emailing BFD@cms.hhs.gov or by posting in the BB2.0, BCDA, DPC, or AB2D Google Groups.
V2 of the APIs will be implemented in summer / fall, 2021. Exact release dates will vary by API. Check your API's Google Group (linked at the bottom of this document) for details.
We are aiming to make V2 available for testing in Sandbox at least two months prior to our production release. Each API will make an announcement in their Google Group when V2 is available to test in the Sandbox.
No. You can continue to use your existing credentials once V2 is fully available.
CMS will make select endpoints available in the sandbox ahead of the V2 launch for testing. If you would like to test these endpoints and help us make improvements, please email us at BFD@cms.hhs.gov.
Yes, V2 (FHIR R4) is not backwards compatible with V1 (FHIR R3). A list of technical differences between R3 and R4 of FHIR can be found here.
Not at this time. V2 will provide FHIR R4 compatible and CARIN Blue Button CPCDS IG conformant endpoints for our existing resources: Patient, Coverage, and ExplanationofBenefit (EOB).
Join the Google Group for any APIs you access for the most up to date information: