Skip to main content
U.S. flag

An official website of the United States government

Official websites use .gov
A .gov website belongs to an official government organization in the United States.

Secure .gov websites use HTTPS
A lock ( ) or https:// means you’ve safely connected to the .gov website. Share sensitive information only on official, secure websites.

VSAC Support Center

VSAC Support Center Home

Retrieve Value Set Expansion for a Specified Expansion Version

Back to Main VSAC SVS API Page

URLs | Query Parameters | Related Utility Calls | Sample Output

URLs with /RetrieveMultipleValueSets using the version parameter support the following use case:

  • Retrieve a value set expansion based on a specified expansion version label that you can specify using a version parameter.
  • Retrieve a value set expansion based on the most recent code system versions in VSAC that you can specify using a version=Latest parameter, or alternatively, if you omit the version parameter your expansion will default to the Latest (most recent code system versions in VSAC).

URLs

The base URL is https://vsac.nlm.nih.gov/vsac/svs

Sample URL Description
https://vsac.nlm.nih.gov/vsac/svs/RetrieveMultipleValueSets?id= 2.16.840.1.113883.3.117.1.7.1.226&version=eCQM Update 2019-05-10 Retrieve the value set expansion and metadata of a value set OID based on the specified expansion version label.

Query Parameters

Parameter name Required? Y/N Description
id Y VSAC value set object identifier (OID)
version Y An expansion version label that uniquely identifies a published value set expansion. For example: 'eCQM Update 2019-05-10' or '20170505'

Related Utility Calls

The base URL for VSAC utility calls is https://vsac.nlm.nih.gov/vsac/

URL Description
https://vsac.nlm.nih.gov/vsac/oid/{oid}/versions Retrieve list of expansion version labels available for a given OID.

Sample Output

Sample output for https://vsac.nlm.nih.gov/vsac/svs/RetrieveMultipleValueSets?id= 2.16.840.1.113883.3.117.1.7.1.226&version=eCQM Update 2019-05-10

  • Value set definition version is the <RevisionDate> element.
  • Value set expansion version is the value of the version attribute within the <ns0:DescribedValueSet> element.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ns0:RetrieveMultipleValueSetsResponse xmlns:ns0="urn:ihe:iti:svs:2008" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <ns0:DescribedValueSet ID="2.16.840.1.113883.3.117.1.7.1.226" displayName="Thrombolytic (t-PA) Therapy" version="eCQM Update 2019-05-10">
        <ns0:ConceptList>
            <ns0:Concept code="1804799" codeSystem="2.16.840.1.113883.6.88" codeSystemName="RXNORM" codeSystemVersion="2019-01" displayName="alteplase 100 MG Injection"/>
            <ns0:Concept code="1804804" codeSystem="2.16.840.1.113883.6.88" codeSystemName="RXNORM" codeSystemVersion="2019-01" displayName="alteplase 50 MG Injection"/>
        </ns0:ConceptList>
        <ns0:Source>The Joint Commission</ns0:Source>
        <ns0:Purpose>(Clinical Focus: This value set contains concepts that represent medications that are prescribed for thrombolytic (t-PA) therapy for treatment of ischemic stroke.),(Data Element Scope: This value set may use the Quality Data Model (QDM) category related to Medication. The intent of this data element is to identify patients who are administered appropriate thrombolytic (t-PA) therapy for stroke.),(Inclusion Criteria: Includes only relevant concepts associated with RxNorm thrombolytic medications appropriate for stroke treatment consistent with administration by intravenous (IV) route.),(Exclusion Criteria: No exclusions.)</ns0:Purpose>
        <ns0:Type>Extensional</ns0:Type>
        <ns0:Binding>Dynamic</ns0:Binding>
        <ns0:Status>Active</ns0:Status>
        <ns0:RevisionDate>2017-07-27</ns0:RevisionDate>
        <ns0:Group ID="1" sourceOrganization="National Quality Forum" displayName="CMS eCQM ID">
            <ns0:Keyword>CMS72v8</ns0:Keyword>
        </ns0:Group>
        <ns0:Group ID="1" sourceOrganization="National Quality Forum" displayName="Measure GUID">
            <ns0:Keyword>93f3479f-75d8-4731-9a3f-b7749d8bcd37</ns0:Keyword>
        </ns0:Group>
        <ns0:Group ID="1" sourceOrganization="National Quality Forum" displayName="CMS Clinical Quality Measures">
            <ns0:Keyword>Eligible Hospitals</ns0:Keyword>
        </ns0:Group>
        <ns0:Group ID="1" sourceOrganization="National Quality Forum" displayName="Measure Steward">
            <ns0:Keyword>The Joint Commission</ns0:Keyword>
        </ns0:Group>
        <ns0:Group ID="1" sourceOrganization="National Quality Forum" displayName="eCQM Copyright">
            <ns0:Keyword>LOINC(R) copyright 2004-2018 Regenstrief Institute, Inc.
This material contains SNOMED Clinical Terms(R) (SNOMED CT[R]) copyright 2004-2018 International Health Terminology Standards Development Organisation. All Rights Reserved.

Measure specifications are in the Public Domain</ns0:Keyword>
        </ns0:Group>
        <ns0:Group ID="1" sourceOrganization="National Quality Forum" displayName="Measure Type">
            <ns0:Keyword>PROCESS</ns0:Keyword>
        </ns0:Group>
        <ns0:Group ID="1" sourceOrganization="National Quality Forum" displayName="eCQM Description">
            <ns0:Keyword>Ischemic stroke patients administered antithrombotic therapy by the end of hospital day 2</ns0:Keyword>
        </ns0:Group>
        <ns0:Group ID="1" sourceOrganization="National Quality Forum" displayName="eCQM Status">
            <ns0:Keyword>COMPLETED</ns0:Keyword>
        </ns0:Group>
        <ns0:Group ID="1" sourceOrganization="National Quality Forum" displayName="CATEGORY">
            <ns0:Keyword>Medication</ns0:Keyword>
        </ns0:Group>
        <ns0:Group ID="1" sourceOrganization="National Quality Forum" displayName="NQF Number">
            <ns0:Keyword>Not Applicable</ns0:Keyword>
        </ns0:Group>
        <ns0:Group ID="1" sourceOrganization="National Quality Forum" displayName="Measure Developer">
            <ns0:Keyword>The Joint Commission</ns0:Keyword>
        </ns0:Group>
        <ns0:Group ID="1" sourceOrganization="National Quality Forum" displayName="eCQM Version number">
            <ns0:Keyword>8.1.000</ns0:Keyword>
        </ns0:Group>
        <ns0:Group ID="1" sourceOrganization="National Quality Forum" displayName="eCQM Identifier">
            <ns0:Keyword>72</ns0:Keyword>
        </ns0:Group>
        <ns0:Group ID="1" sourceOrganization="National Quality Forum" displayName="eCQM Title">
            <ns0:Keyword>Antithrombotic Therapy By End of Hospital Day 2</ns0:Keyword>
        </ns0:Group>
    </ns0:DescribedValueSet>
</ns0:RetrieveMultipleValueSetsResponse>

Last Reviewed: September 7, 2023