Skip Navigation Bar
NLM logo

VSAC Support Center

Retrieve Value Set Expansions Published by a Program Release

Back to Main VSAC SVS API Page

URLs | Query Parameters | Related Utility Calls | Sample Output

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

  • Retrieve a value set expansion published by a program release (e.g., CMS eCQM and Hybrid Measure, CMS Pre-rulemaking, HL7 C-CDA, CMS Hybrid Measures) that you can specify using a releaseName.

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&release=eCQM Update 2020-05-07&ticket={ST} Retrieve a value set expansion published by the CMS eCQM Update 2020-05-07 program release, includes value set metadata and code list.
https://vsac.nlm.nih.gov/vsac/svs/RetrieveValueSet?id=2.16.840.1.113883.3.117.1.7.1.226&release=eCQM Update 2020-05-07&ticket={ST} Retrieve a value set expansion published by the CMS eCQM Update 2020-05-07 program release, includes value set code list, and no metadata.

Query Parameters

Parameter name Required? Y/N Description
ticket Y A single-use service ticket (ST) is required for each call to the VSAC SVS API.
id Y VSAC value set object identifier (OID)
release Y Name of a program release. A program release contains multiple pre-selected value sets designated by the program's release manager.

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/programs Retrieve the list of program names, and their descriptions, supported by VSAC. For example, programs such as CMS eCQM and Hybrid Measure, CMS Pre-rulemaking eCQM, CMS Hybrid, and HL7 C-CDA.
https://vsac.nlm.nih.gov/vsac/program/{programName} Retrieve the program descriptions, and the list of published program release names and releaseDates for a given program name.
https://vsac.nlm.nih.gov/vsac/oid/2.16.840.1.113883.3.117.1.7.1.226/program/CMS eCQM and Hybrid Measure Retrieve the program descriptions, and the list of published program release names for a given value set OID and program name.
https://vsac.nlm.nih.gov/vsac/oid/{oid}/programs Retrieve the list of programs with which the given OID is associated.

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&release=eCQM Update 2020-05-07&ticket={ST}

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

(retrieved 05/20/2020)


<?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 2020-05-07">
        <ns0:ConceptList>
            <ns0:Concept code="1804799" codeSystem="2.16.840.1.113883.6.88" codeSystemName="RXNORM" codeSystemVersion="2020-01" displayName="alteplase 100 MG Injection"/>
            <ns0:Concept code="1804804" codeSystem="2.16.840.1.113883.6.88" codeSystemName="RXNORM" codeSystemVersion="2020-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>CMS72v9</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>Measure specifications are in the Public Domain

LOINC(R) copyright 2004-2019 Regenstrief Institute, Inc. 
This material contains SNOMED Clinical Terms(R) (SNOMED CT[R]) copyright 2004-2019 International Health Terminology Standards Development Organisation. All Rights Reserved.</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>9.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>

Sample output for https://vsac.nlm.nih.gov/vsac/svs/RetrieveValueSet?id=2.16.840.1.113883.3.117.1.7.1.226&release=eCQM Update 2020-05-07&ticket={ST}

(retrieved 05/20/2020)


<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ns0:RetrieveValueSetResponse xmlns:ns0="urn:ihe:iti:svs:2008" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <ns0:ValueSet ID="2.16.840.1.113883.3.117.1.7.1.226" displayName="Thrombolytic (t-PA) Therapy">
        <ns0:ConceptList>
            <ns0:Concept code="1804799" codeSystem="2.16.840.1.113883.6.88" codeSystemName="RXNORM" codeSystemVersion="2020-01" displayName="alteplase 100 MG Injection"/>
            <ns0:Concept code="1804804" codeSystem="2.16.840.1.113883.6.88" codeSystemName="RXNORM" codeSystemVersion="2020-01" displayName="alteplase 50 MG Injection"/>
        </ns0:ConceptList>
    </ns0:ValueSet>
</ns0:RetrieveValueSetResponse>

Last Reviewed: May 20, 2020