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 a Value Set Expansion Published on or before a Specific Date

Back to Main VSAC SVS API Page

URLs | Query Parameters | Related Utility Calls | Sample Output

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

  • Retrieve the value set expansion published on or before the specified effective date that you specify using the effectiveDate parameter.

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&effectiveDate=20190510 Retrieve the specified value set OID's expanded code list and metadata based on the specified effective date. Does not include eCQM measure-specific metadata.
https://vsac.nlm.nih.gov/vsac/svs/RetrieveMultipleValueSets?id=2.16.840.1.113883.3.117.1.7.1.226&effectiveDate=20190510&programType=eCQM Retrieve the specified value set OID's expanded code list and metadata published in the most recent eCQM program release and available on or before the specified effectiveDate. Includes eCQM measure-specific metadata. Only one available value for programType: eCQM

Query Parameters

Parameter name Required? Y/N Description
id Y VSAC value set object identifier (OID)
effectiveDate Y A date on or before which a published value set expansion is published and available in the VSAC public repository.
programType N The name of a program that contains the requested OID. Available value: eCQM

Related Utility Calls

N/A

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&effectiveDate=20190510

  • 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:DescribedValueSet>
</ns0:RetrieveMultipleValueSetsResponse>

Sample output for https://vsac.nlm.nih.gov/vsac/svs/RetrieveMultipleValueSets?id=2.16.840.1.113883.3.117.1.7.1.226&effectiveDate=20190510&programType=eCQM

  • 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