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

VSAC Support Center Home

Mapping of Value Set Review Statuses between VSAC and FHIR


VSAC value set review statuses are more granular than FHIR ValueSet.status values.
We use FHIR’s Canonical Status to map VSAC review status to FHIR status.

VSAC Review Status FHIR ValueSet.status
Active active
Not Maintained retired
Deprecated retired
Retired retired

A VSAC FHIR API search of a VSAC value set OID using status=retired, and a url parameter, returns all value set definition versions, for that value set OID, that have a VSAC review status of Not Maintained, Deprecated or Retired.

Here is an example VSAC FHIR API request for a value set that has a status of Not Maintained. Try this API request in an API client, such as Postman, or in a software program.

    https://cts.nlm.nih.gov/fhir/ValueSet?status=retired&url=http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113762.1.4.1032.190

See our Capability Statement for the VSAC-to-FHIR mapping of value set review statuses.

Last Reviewed: August 16, 2024