Skip Navigation Bar
NLM logo

VSAC Support Center

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&ticket={ST} 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&ticket={ST} 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
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)
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&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.

<?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&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.

<?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: March 2, 2020