The National Library of Medicine is pleased to announce the Value Set Authority Center (VSAC) publication and downloadable files for the 2023-08-15 release of the HL7 Consolidated Clinical Document Architecture (C-CDA) R2.1 value sets, authored by the HL7 Terminology group and sponsored by the Office of the National Coordinator for Health Information Technology (ONC). This release contains 149 C-CDA value sets.

There are 5 new value sets in this 2023 release compared to last year's 2022 release:

Value Set Name	Value Set OID
Social Determinants of Health Condition	2.16.840.1.113762.1.4.1240.1
Social Determinants of Health Goals	2.16.840.1.113762.1.4.1247.71
Social Determinants of Health Procedures	2.16.840.1.113762.1.4.1196.789
Social Determinants of Health Service Requests	2.16.840.1.113762.1.4.1196.790
Sex	2.16.840.1.113762.1.4.1240.3

There are several ways you can access the C-CDA value sets:

• VSAC Welcome Page: The Search button in the HL7 C-CDA Value Sets program block leads you to the VSAC Search Value Sets web browser, prefiltered by this HL7 C-CDA release. The Download link in the HL7 C-CDA Value Sets program block leads you to the C-CDA Value Sets section of the VSAC Download tab and supplies prepackaged downloadable files.
• VSAC Download Tab: Here, you can download the Excel, pipe-delimited text files, and XML files of the C-CDA value sets; Code System Versions Currently in C-CDA R2.1 Value Sets; A list of C-CDA R2.1 Value Sets Available in VSAC; A list of C-CDA R2.1 Value Sets Unavailable in VSAC. The published downloadable C-CDA R2.1 2022-08-15 release excludes 24 C-CDA value sets for which VSAC does not have the required supporting code systems.
• VSAC Search Value Sets Tab: In the VSAC web browser, you can search, sort, filter and view details for all or individual C-CDA value sets; use the Export Search Results button to download a catalog of C-CDA value set expansions; To download all 2023 C-CDA value set expansions as Excel, XML, or Text files, increase the paging to 120 rows and use the checkboxes to select value sets. Repeat as necessary.
• VSAC SVS API: Given a C-CDA value set identifier (OID) that you can obtain by any of the above methods, use an SVS API call, such as: [https://vsac.nlm.nih.gov/vsac/svs/RetrieveMultipleValueSets?id=2.16.840.1.113883.1.11.16866&release=C-CDA R2.1 2023-08-15&ticket=your-service-ticket]
• VSAC FHIR API: [https://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.11.20.9.46/$expand?expansion=C-CDA R2.1 2023-08-15]

For additional information on API authentication and usage, see our API documentation.

Please send any questions or feedback regarding VSAC functionality to: NLM Customer Support.