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.


The base URL is

Sample URL Description 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

URL Description Return the list of available expansion profiles.

Sample Output

Sample output for 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="">
    <ns0:DescribedValueSet ID="2.16.840.1.113883." displayName="Thrombolytic (t-PA) Therapy" version="N/A">
            <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: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>

Last Reviewed: March 2, 2020