Skip Navigation Bar
NLM logo

VSAC Support Center

Retrieve Value Set Expansion Calculated with Expansion Profile

Back to Main VSAC SVS API Page

URLs | Query Parameters | Related Utility Calls | Sample Output

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

  • Retrieve a temporary trial value set expansion of the most recently published value set definition based on your specified expansion profile label that you can specify using a profile parameter. A trial expansion does not exist in the public repository. If the value set definition is in draft status, the API will return no results.

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&profile=eCQM Update 2019-05-10&ticket={ST} Retrieve a temporary trial value set expansion calculated by the CMS eCQM Update 2019-05-10 expansion profile, includes value set code list, and metadata. A trial expansion does not exist in the public repository.

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)
profile Y An expansion profile label that defines a calculation algorithm containing predetermined code system versions and legacy codes. For example: 'eCQM Update 2019-05-10'

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/profiles Return the list of available expansion profiles.

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&profile=eCQM Update 2019-05-10&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. When version="N/A" this means you have asked the VSAC SVS API to perform a temporary trial expansion/calculation of either a definition version or of a draft definition. A trial expansion does not exist in the public repository.

<?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="N/A">
        <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>

Last Reviewed: March 2, 2020