NLM developed utility calls as a method to retrieve metadata associated with value sets. These utility calls are not associated with the SVS API and do not adhere to the SVS specification. Utility calls require no authentication.
Utility calls using tagName and tagValue parameters support the following use cases:
- Retrieve available values for tagNames that will enable you to then retrieve values for a tagName of interest, like CMS eMeasure ID.
- Retrieve available values for CMS eMeasure IDs so that you can use a specific CMS eMeasure ID to retrieve all value set expansions specified by that CMS eMeasure ID.
- Retrieve available values for eMeasure Identifiers so that you can use a specific eMeasure Identifier to retrieve all value set expansions specified by that eMeasure Identifier.
- Retrieve available values for NQF Numbers so that you can use a specific NQF Number to retrieve all value set expansions specified by that NQF Number.
Related VSAC SVS API Endpoint Calls: see Retrieve Expansions for All Value Sets Specified by a CMS eMeasure ID, or eMeasure Identifier, or NQF Number
Query Parameters
Parameter name | Required? Y/N | Description |
---|---|---|
tagNames | Y | Retrieves all supported tagNames |
tagName | Y | A tag for a collection of value sets, for example: 'CMS eMeasure ID'. Must be used together with 'tagValue'. |
tagValues | Y | Retrieves supported tagValues for specified tagName. |
tagValue | Y | A value of a member within a collection of value sets. For example, 'CMS68v9' is one of the valid values within CMS eMeasure ID. |
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/tagNames | Retrieve available values for tagNames: 'CMS eMeasure ID', 'eMeasure Identifier', and 'NQF Number'. |
https://vsac.nlm.nih.gov/vsac/tagName/CMS eMeasure ID/tagValues | Retrieve available values for CMS eMeasure IDs. |
https://vsac.nlm.nih.gov/vsac/tagName/eMeasure Identifier/tagValues | Retrieve available values for eMeasure Identifiers. |
https://vsac.nlm.nih.gov/vsac/tagName/NQF Number/tagValues | Retrieve available values for NQF Numbers. |
Sample Output
Sample output for https://vsac.nlm.nih.gov/vsac/tagNames (retrieved 01/03/2020)
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<tagNames>
<name>CMS eMeasure ID|CMS eCQM ID</name>
<name>eMeasure Identifier|eCQM Identifier</name>
<name>NQF Number</name>
</tagNames>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<tagValues tagName="CMS eMeasure ID">
<value>CMS100v1</value>
<value>CMS100v2</value>
<value>CMS100v3</value>
<value>CMS100v4</value>
<value>CMS100v5</value>
<value>CMS102v1</value>
<value>CMS102v2</value>
<value>CMS102v3</value>
<value>CMS102v4</value>
<value>CMS102v5</value>
<value>CMS102v6</value>
<value>CMS104v1</value>
<value>CMS104v2</value>
<value>CMS104v3</value>
<value>CMS104v4</value>
<value>CMS104v5</value>
<value>CMS104v6</value>
<value>CMS105v1</value>
<value>CMS105v2</value>
<value>CMS105v3</value>
<value>CMS105v4</value>
<value>CMS105v5</value>
<value>CMS105v6</value>
<value>CMS107v1</value>
<value>CMS107v2</value>
<value>CMS107v3</value>
<value>CMS107v4</value>
<value>CMS107v5</value>
<value>CMS107v6</value>
<value>CMS108v1</value>
<value>CMS108v2</value>
<value>CMS108v3</value>
<value>CMS108v4</value>
<value>CMS108v5</value>
<value>CMS108v6</value>
<value>CMS109v1</value>
<value>CMS109v2</value>
<value>CMS109v3</value>
<value>CMS109v4</value>
<value>CMS109v5</value>
<value>CMS110v1</value>
<value>CMS110v2</value>
<value>CMS110v3</value>
<value>CMS110v4</value>
<value>CMS110v5</value>
<value>CMS111v1</value>
<value>CMS111v2</value>
<value>CMS111v3</value>
<value>CMS111v4</value>
<value>CMS111v5</value>
<value>CMS111v6</value>
<value>CMS113v1</value>
<value>CMS113v2</value>
<value>CMS113v3</value>
<value>CMS113v4</value>
<value>CMS113v5</value>
<value>CMS113v6</value>
<value>CMS114v1</value>
<value>CMS114v2</value>
<value>CMS114v3</value>
<value>CMS114v4</value>
<value>CMS114v5</value>
<value>CMS117v1</value>
<value>CMS117v2</value>
<value>CMS117v3</value>
<value>CMS117v4</value>
<value>CMS117v5</value>
<value>CMS117v6</value>
<value>CMS122v1</value>
<value>CMS122v2</value>
<value>CMS122v3</value>
<value>CMS122v4</value>
<value>CMS122v5</value>
<value>CMS122v6</value>
<value>CMS123v1</value>
<value>CMS123v2</value>
<value>CMS123v3</value>
<value>CMS123v4</value>
<value>CMS123v5</value>
<value>CMS123v6</value>
<value>CMS124v1</value>
<value>CMS124v2</value>
<value>CMS124v3</value>
<value>CMS124v4</value>
<value>CMS124v5</value>
<value>CMS124v6</value>
<value>CMS125v1</value>
<value>CMS125v2</value>
<value>CMS125v3</value>
<value>CMS125v4</value>
<value>CMS125v5</value>
<value>CMS125v6</value>
<value>CMS126v1</value>
<value>CMS126v2</value>
<value>CMS126v3</value>
<value>CMS126v4</value>
<value>CMS126v5</value>
<value>CMS127v1</value>
<value>CMS127v2</value>
<value>CMS127v3</value>
<value>CMS127v4</value>
<value>CMS127v5</value>
<value>CMS127v6</value>
<value>CMS128v1</value>
<value>CMS128v2</value>
<value>CMS128v3</value>
<value>CMS128v4</value>
<value>CMS128v5</value>
<value>CMS128v6</value>
<value>CMS129v1</value>
<value>CMS129v2</value>
<value>CMS129v3</value>
<value>CMS129v4</value>
<value>CMS129v5</value>
<value>CMS129v6</value>
<value>CMS129v7</value>
<value>CMS130v1</value>
<value>CMS130v2</value>
<value>CMS130v3</value>
<value>CMS130v4</value>
<value>CMS130v5</value>
<value>CMS130v6</value>
<value>CMS131v1</value>
<value>CMS131v2</value>
<value>CMS131v3</value>
<value>CMS131v4</value>
<value>CMS131v5</value>
<value>CMS131v6</value>
<value>CMS132v1</value>
<value>CMS132v2</value>
<value>CMS132v3</value>
<value>CMS132v4</value>
<value>CMS132v5</value>
<value>CMS132v6</value>
<value>CMS133v1</value>
<value>CMS133v2</value>
<value>CMS133v3</value>
<value>CMS133v4</value>
<value>CMS133v5</value>
<value>CMS133v6</value>
<value>CMS134v1</value>
<value>CMS134v2</value>
<value>CMS134v3</value>
<value>CMS134v4</value>
<value>CMS134v5</value>
<value>CMS134v6</value>
<value>CMS135v1</value>
<value>CMS135v2</value>
<value>CMS135v3</value>
<value>CMS135v4</value>
<value>CMS135v5</value>
<value>CMS135v6</value>
<value>CMS136v1</value>
<value>CMS136v2</value>
<value>CMS136v3</value>
<value>CMS136v4</value>
<value>CMS136v5</value>
<value>CMS136v6</value>
<value>CMS136v7</value>
<value>CMS137v1</value>
<value>CMS137v2</value>
<value>CMS137v3</value>
<value>CMS137v4</value>
<value>CMS137v5</value>
<value>CMS137v6</value>
<value>CMS138v1</value>
<value>CMS138v2</value>
<value>CMS138v3</value>
<value>CMS138v4</value>
<value>CMS138v5</value>
<value>CMS138v6</value>
<value>CMS139v1</value>
<value>CMS139v2</value>
<value>CMS139v3</value>
<value>CMS139v4</value>
<value>CMS139v5</value>
<value>CMS139v6</value>
<value>CMS140v1</value>
<value>CMS140v2</value>
<value>CMS140v3</value>
<value>CMS140v4</value>
<value>CMS140v5</value>
<value>CMS141v1</value>
<value>CMS141v2</value>
<value>CMS141v3</value>
<value>CMS141v4</value>
<value>CMS141v5</value>
<value>CMS141v6</value>
<value>CMS142v1</value>
<value>CMS142v2</value>
<value>CMS142v3</value>
<value>CMS142v4</value>
<value>CMS142v5</value>
<value>CMS142v6</value>
<value>CMS143v1</value>
<value>CMS143v2</value>
<value>CMS143v3</value>
<value>CMS143v4</value>
<value>CMS143v5</value>
<value>CMS143v6</value>
<value>CMS144v1</value>
<value>CMS144v2</value>
<value>CMS144v3</value>
<value>CMS144v4</value>
<value>CMS144v5</value>
<value>CMS144v6</value>
<value>CMS145v1</value>
<value>CMS145v2</value>
<value>CMS145v3</value>
<value>CMS145v4</value>
<value>CMS145v5</value>
<value>CMS145v6</value>
<value>CMS146v1</value>
<value>CMS146v2</value>
<value>CMS146v3</value>
<value>CMS146v4</value>
<value>CMS146v5</value>
<value>CMS146v6</value>
<value>CMS147v1</value>
<value>CMS147v2</value>
<value>CMS147v3</value>
<value>CMS147v4</value>
<value>CMS147v5</value>
<value>CMS147v6</value>
<value>CMS147v7</value>
<value>CMS148v1</value>
<value>CMS148v2</value>
<value>CMS148v3</value>
<value>CMS148v4</value>
<value>CMS148v5</value>
<value>CMS149v1</value>
<value>CMS149v2</value>
<value>CMS149v3</value>
<value>CMS149v4</value>
<value>CMS149v5</value>
<value>CMS149v6</value>
<value>CMS153v1</value>
<value>CMS153v2</value>
<value>CMS153v3</value>
<value>CMS153v4</value>
<value>CMS153v5</value>
<value>CMS153v6</value>
<value>CMS154v1</value>
<value>CMS154v2</value>
<value>CMS154v3</value>
<value>CMS154v4</value>
<value>CMS154v5</value>
<value>CMS154v6</value>
<value>CMS155v1</value>
<value>CMS155v2</value>
<value>CMS155v3</value>
<value>CMS155v4</value>
<value>CMS155v5</value>
<value>CMS155v6</value>
<value>CMS156v1</value>
<value>CMS156v2</value>
<value>CMS156v3</value>
<value>CMS156v4</value>
<value>CMS156v5</value>
<value>CMS156v6</value>
<value>CMS157v1</value>
<value>CMS157v2</value>
<value>CMS157v3</value>
<value>CMS157v4</value>
<value>CMS157v5</value>
<value>CMS157v6</value>
<value>CMS158v1</value>
<value>CMS158v2</value>
<value>CMS158v3</value>
<value>CMS158v4</value>
<value>CMS158v5</value>
<value>CMS158v6</value>
<value>CMS159v1</value>
<value>CMS159v2</value>
<value>CMS159v3</value>
<value>CMS159v4</value>
<value>CMS159v5</value>
<value>CMS159v6</value>
<value>CMS160v1</value>
<value>CMS160v2</value>
<value>CMS160v3</value>
<value>CMS160v4</value>
<value>CMS160v5</value>
<value>CMS160v6</value>
<value>CMS161v1</value>
<value>CMS161v2</value>
<value>CMS161v3</value>
<value>CMS161v4</value>
<value>CMS161v5</value>
<value>CMS161v6</value>
<value>CMS163v1</value>
<value>CMS163v2</value>
<value>CMS163v3</value>
<value>CMS163v4</value>
<value>CMS163v5</value>
<value>CMS164v1</value>
<value>CMS164v2</value>
<value>CMS164v3</value>
<value>CMS164v4</value>
<value>CMS164v5</value>
<value>CMS164v6</value>
<value>CMS165v1</value>
<value>CMS165v2</value>
<value>CMS165v3</value>
<value>CMS165v4</value>
<value>CMS165v5</value>
<value>CMS165v6</value>
<value>CMS166v1</value>
<value>CMS166v2</value>
<value>CMS166v3</value>
<value>CMS166v4</value>
<value>CMS166v5</value>
<value>CMS166v6</value>
<value>CMS166v7</value>
<value>CMS167v1</value>
<value>CMS167v2</value>
<value>CMS167v3</value>
<value>CMS167v4</value>
<value>CMS167v5</value>
<value>CMS167v6</value>
<value>CMS169v1</value>
<value>CMS169v2</value>
<value>CMS169v3</value>
<value>CMS169v4</value>
<value>CMS169v5</value>
<value>CMS169v6</value>
<value>CMS171v1</value>
<value>CMS171v2</value>
<value>CMS171v3</value>
<value>CMS171v4</value>
<value>CMS171v5</value>
<value>CMS171v6</value>
<value>CMS172v1</value>
<value>CMS172v2</value>
<value>CMS172v3</value>
<value>CMS172v4</value>
<value>CMS172v5</value>
<value>CMS172v6</value>
<value>CMS177v1</value>
<value>CMS177v2</value>
<value>CMS177v3</value>
<value>CMS177v4</value>
<value>CMS177v5</value>
<value>CMS177v6</value>
<value>CMS178v1</value>
<value>CMS178v2</value>
<value>CMS178v3</value>
<value>CMS178v4</value>
<value>CMS178v5</value>
<value>CMS178v6</value>
<value>CMS179v1</value>
<value>CMS179v2</value>
<value>CMS179v3</value>
<value>CMS179v4</value>
<value>CMS179v5</value>
<value>CMS182v1</value>
<value>CMS182v3</value>
<value>CMS182v4</value>
<value>CMS182v5</value>
<value>CMS182v6</value>
<value>CMS185v1</value>
<value>CMS185v2</value>
<value>CMS185v3</value>
<value>CMS185v4</value>
<value>CMS185v5</value>
<value>CMS188v1</value>
<value>CMS188v2</value>
<value>CMS188v3</value>
<value>CMS188v4</value>
<value>CMS188v5</value>
<value>CMS188v6</value>
<value>CMS190v1</value>
<value>CMS190v2</value>
<value>CMS190v3</value>
<value>CMS190v4</value>
<value>CMS190v5</value>
<value>CMS190v6</value>
<value>CMS22v1</value>
<value>CMS22v2</value>
<value>CMS22v3</value>
<value>CMS22v4</value>
<value>CMS22v5</value>
<value>CMS22v6</value>
<value>CMS26v1</value>
<value>CMS26v2</value>
<value>CMS26v3</value>
<value>CMS26v4</value>
<value>CMS26v5</value>
<value>CMS2v1</value>
<value>CMS2v2</value>
<value>CMS2v3</value>
<value>CMS2v4</value>
<value>CMS2v5</value>
<value>CMS2v6</value>
<value>CMS2v7</value>
<value>CMS30v1</value>
<value>CMS30v2</value>
<value>CMS30v3</value>
<value>CMS30v4</value>
<value>CMS30v5</value>
<value>CMS30v6</value>
<value>CMS31v1</value>
<value>CMS31v2</value>
<value>CMS31v3</value>
<value>CMS31v4</value>
<value>CMS31v5</value>
<value>CMS31v6</value>
<value>CMS32v1</value>
<value>CMS32v2</value>
<value>CMS32v3</value>
<value>CMS32v4</value>
<value>CMS32v5</value>
<value>CMS32v6</value>
<value>CMS32v7</value>
<value>CMS347v1</value>
<value>CMS50v1</value>
<value>CMS50v2</value>
<value>CMS50v3</value>
<value>CMS50v4</value>
<value>CMS50v5</value>
<value>CMS50v6</value>
<value>CMS529v0</value>
<value>CMS52v1</value>
<value>CMS52v2</value>
<value>CMS52v3</value>
<value>CMS52v4</value>
<value>CMS52v5</value>
<value>CMS52v6</value>
<value>CMS53v1</value>
<value>CMS53v2</value>
<value>CMS53v3</value>
<value>CMS53v4</value>
<value>CMS53v5</value>
<value>CMS53v6</value>
<value>CMS55v1</value>
<value>CMS55v2</value>
<value>CMS55v3</value>
<value>CMS55v4</value>
<value>CMS55v5</value>
<value>CMS55v6</value>
<value>CMS56v1</value>
<value>CMS56v2</value>
<value>CMS56v3</value>
<value>CMS56v4</value>
<value>CMS56v5</value>
<value>CMS56v6</value>
<value>CMS60v1</value>
<value>CMS60v2</value>
<value>CMS60v3</value>
<value>CMS60v4</value>
<value>CMS60v5</value>
<value>CMS61v1</value>
<value>CMS61v2</value>
<value>CMS61v3</value>
<value>CMS61v4</value>
<value>CMS61v5</value>
<value>CMS61v6</value>
<value>CMS62v1</value>
<value>CMS62v2</value>
<value>CMS62v3</value>
<value>CMS62v4</value>
<value>CMS62v5</value>
<value>CMS645v1</value>
<value>CMS64v1</value>
<value>CMS64v2</value>
<value>CMS64v3</value>
<value>CMS64v4</value>
<value>CMS64v5</value>
<value>CMS64v6</value>
<value>CMS65v1</value>
<value>CMS65v2</value>
<value>CMS65v3</value>
<value>CMS65v4</value>
<value>CMS65v5</value>
<value>CMS65v6</value>
<value>CMS65v7</value>
<value>CMS66v1</value>
<value>CMS66v2</value>
<value>CMS66v3</value>
<value>CMS66v4</value>
<value>CMS66v5</value>
<value>CMS66v6</value>
<value>CMS68v1</value>
<value>CMS68v2</value>
<value>CMS68v3</value>
<value>CMS68v4</value>
<value>CMS68v5</value>
<value>CMS68v6</value>
<value>CMS68v7</value>
<value>CMS69v1</value>
<value>CMS69v2</value>
<value>CMS69v3</value>
<value>CMS69v4</value>
<value>CMS69v5</value>
<value>CMS69v6</value>
<value>CMS71v1</value>
<value>CMS71v2</value>
<value>CMS71v3</value>
<value>CMS71v4</value>
<value>CMS71v5</value>
<value>CMS71v6</value>
<value>CMS71v7</value>
<value>CMS72v1</value>
<value>CMS72v2</value>
<value>CMS72v3</value>
<value>CMS72v4</value>
<value>CMS72v5</value>
<value>CMS72v6</value>
<value>CMS73v1</value>
<value>CMS73v2</value>
<value>CMS73v3</value>
<value>CMS73v4</value>
<value>CMS73v5</value>
<value>CMS74v1</value>
<value>CMS74v2</value>
<value>CMS74v3</value>
<value>CMS74v4</value>
<value>CMS74v5</value>
<value>CMS74v6</value>
<value>CMS74v7</value>
<value>CMS75v1</value>
<value>CMS75v2</value>
<value>CMS75v3</value>
<value>CMS75v4</value>
<value>CMS75v5</value>
<value>CMS75v6</value>
<value>CMS77v1</value>
<value>CMS77v2</value>
<value>CMS77v3</value>
<value>CMS77v4</value>
<value>CMS77v5</value>
<value>CMS82v1</value>
<value>CMS82v2</value>
<value>CMS82v3</value>
<value>CMS82v4</value>
<value>CMS82v5</value>
<value>CMS90v1</value>
<value>CMS90v2</value>
<value>CMS90v3</value>
<value>CMS90v4</value>
<value>CMS90v5</value>
<value>CMS90v6</value>
<value>CMS90v7</value>
<value>CMS91v1</value>
<value>CMS91v2</value>
<value>CMS91v3</value>
<value>CMS91v4</value>
<value>CMS91v5</value>
<value>CMS91v6</value>
<value>CMS9v1</value>
<value>CMS9v2</value>
<value>CMS9v3</value>
<value>CMS9v4</value>
<value>CMS9v5</value>
<value>CMS9v6</value>
</tagValues>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<tagValues tagName="eMeasure Identifier">
<value>100</value>
<value>102</value>
<value>104</value>
<value>105</value>
<value>107</value>
<value>108</value>
<value>109</value>
<value>110</value>
<value>111</value>
<value>113</value>
<value>114</value>
<value>117</value>
<value>122</value>
<value>123</value>
<value>124</value>
<value>125</value>
<value>126</value>
<value>127</value>
<value>128</value>
<value>129</value>
<value>130</value>
<value>131</value>
<value>132</value>
<value>133</value>
<value>134</value>
<value>135</value>
<value>136</value>
<value>137</value>
<value>138</value>
<value>139</value>
<value>140</value>
<value>141</value>
<value>142</value>
<value>143</value>
<value>144</value>
<value>145</value>
<value>146</value>
<value>147</value>
<value>148</value>
<value>149</value>
<value>153</value>
<value>154</value>
<value>155</value>
<value>156</value>
<value>157</value>
<value>158</value>
<value>159</value>
<value>160</value>
<value>161</value>
<value>163</value>
<value>164</value>
<value>165</value>
<value>166</value>
<value>167</value>
<value>169</value>
<value>171</value>
<value>172</value>
<value>177</value>
<value>178</value>
<value>179</value>
<value>182</value>
<value>185</value>
<value>188</value>
<value>190</value>
<value>2</value>
<value>22</value>
<value>26</value>
<value>30</value>
<value>31</value>
<value>32</value>
<value>347</value>
<value>50</value>
<value>52</value>
<value>529</value>
<value>53</value>
<value>55</value>
<value>56</value>
<value>60</value>
<value>61</value>
<value>62</value>
<value>64</value>
<value>645</value>
<value>65</value>
<value>66</value>
<value>68</value>
<value>69</value>
<value>71</value>
<value>72</value>
<value>73</value>
<value>74</value>
<value>75</value>
<value>77</value>
<value>82</value>
<value>9</value>
<value>90</value>
<value>91</value>
</tagValues>
Sample output for https://vsac.nlm.nih.gov/vsac/tagName/NQF Number/tagValues (retrieved 01/03/2020)
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<tagValues tagName="NQF Number">
<value>0002</value>
<value>0004</value>
<value>0018</value>
<value>0022</value>
<value>0024</value>
<value>0028</value>
<value>0028e</value>
<value>0031</value>
<value>0032</value>
<value>0033</value>
<value>0034</value>
<value>0036</value>
<value>0038</value>
<value>0041</value>
<value>0041e</value>
<value>0043</value>
<value>0052</value>
<value>0055</value>
<value>0056</value>
<value>0059</value>
<value>0060</value>
<value>0062</value>
<value>0064</value>
<value>0068</value>
<value>0069</value>
<value>0070</value>
<value>0070e</value>
<value>0075</value>
<value>0081</value>
<value>0081e</value>
<value>0083</value>
<value>0083e</value>
<value>0086</value>
<value>0086e</value>
<value>0088</value>
<value>0089</value>
<value>0089e</value>
<value>0101</value>
<value>0104</value>
<value>0104e</value>
<value>0105</value>
<value>0108</value>
<value>0110</value>
<value>0142</value>
<value>0147</value>
<value>0163</value>
<value>0164</value>
<value>0338</value>
<value>0371</value>
<value>0372</value>
<value>0373</value>
<value>0374</value>
<value>0375</value>
<value>0376</value>
<value>0384</value>
<value>0384e</value>
<value>0385</value>
<value>0387</value>
<value>0389</value>
<value>0389e</value>
<value>0403</value>
<value>0405</value>
<value>0418</value>
<value>0418e</value>
<value>0419</value>
<value>0419e</value>
<value>0421</value>
<value>0421e</value>
<value>0435</value>
<value>0436</value>
<value>0437</value>
<value>0438</value>
<value>0439</value>
<value>0440</value>
<value>0441</value>
<value>0453</value>
<value>0469</value>
<value>0480</value>
<value>0480e</value>
<value>0495</value>
<value>0496</value>
<value>0497</value>
<value>0527</value>
<value>0528</value>
<value>0564</value>
<value>0564e</value>
<value>0565</value>
<value>0565e</value>
<value>0608</value>
<value>0639</value>
<value>0710</value>
<value>0710e</value>
<value>0712</value>
<value>0712e</value>
<value>0716</value>
<value>1354</value>
<value>1365</value>
<value>1365e</value>
<value>1401</value>
<value>2372</value>
<value>2872</value>
<value>2872e</value>
<value>2907</value>
<value>2908</value>
<value>3316e</value>
</tagValues>
Last Reviewed: March 2, 2020