SNOMED CT Status API


The SNOMED CT Status API is a web service for accessing the current status of SNOMED CT concepts. Users can access the web service either through the RESTful interface or via the SOAP interface.

RESTful Interface

The RESTful interface has two resources:

  • https://rxnav.nlm.nih.gov/REST/SnomedCT/status?id=someID

  • https://rxnav.nlm.nih.gov/REST/SnomedCT/version

Example
https://rxnav.nlm.nih.gov/REST/SnomedCT/status?id=187959005

<snomedctStatus>
  <inputId>187959005</inputId>
  <status>2</status>
  <effectiveTime>20120131</effectiveTime>
  <mappedId>449627008</mappedId>
  <mappedId>449628003</mappedId>
</snomedctStatus>


https://rxnav.nlm.nih.gov/REST/SnomedCT/version

<snomedctStatus>
  <version>International: 20140131; U.S.: 20130901</version>
</snomedctStatus>

SOAP Interface

The WSDL defining the SOAP interface is located here.

The SOAP web service has two functions:

getStatus( id)
   where id is a SNOMED CT identifier.

getStatus returns a structure containing:

STATUS - possible values are -1 (unknown/invalid id), 0 (retired), 1 (active), 2 (moved)
EFFTIME - the version of the latest change
ID (array) - the SNOMED CT identifier(s), either the original for status= -1, 0, 1 or the moved ids for status=2

getVersion()

get the version of the SNOMED CT database

Examples
getStatus(187959005)

(returns)
  STATUS: 2, EFFTIME: 20120131, ID: {449627008, 449628003}

getStatus(449628003)

(returns)

  STATUS: 1, EFFTIME: 20120131, ID: {449628003}

getVersion()

(returns)

  International: 20140131; U.S.: 20130901

Contact

Email: Olivier Bodenreider