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

Retrieve Value Set Expansion Calculated with Expansion Profile

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 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
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

  • 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: September 7, 2023