SNOMED Documentation Search

 Other Documents
Skip to end of metadata
Go to start of metadata

Section 2 defines a set of URI spaces that are used to identify a variety of SNOMED CT resources, but it does not discuss resolving these URIs. The URIs in the standard use the http scheme and the domain name, which is owned by SNOMED International. This means that SNOMED International is in control of whether or not these URIs, when treated as URLs and resolved, will result in a document being available, a 404 ("Not Found") error, or something else.

However, a Release Centre or other service provider may also want to support the resolution of these URIs. A general approach to this involves deploying a resolving service with an endpoint URL such as


which is configured to resolve URLs that embed SNOMED CT URIs. Continuing the example, a URL of the following form

  • (1){...}

might be redirected with an HTTP response code of 303 to

  • (2){...}

which in turn resolves and returns an appropriate document. Conceptually, we can think of the original URL (1) as identifying what the MyService endpoint knows about the identified SNOMED CT resource, and the returned document, identified by the second URL (2), as being a representation of that knowledge.

What might such a document look like? Let us consider the example URL


The document ultimately returned by the service might be in JSON or XML or HTML or plain text format and contain information indicating that the SCTID is valid, and refers to a non-extension Concept1 . It might also indicate that the service knows about one or more Editions or Versions in which this Concept is defined. It might further supply the Fully Specified Name for the Concept as given in the Version with the most recent effectiveTime. Note that the exact nature of what the service says about the Concept is up to the service itself. One service may offer a RESTful API that allows detailed querying down to the primitive/fully defined status of a versioned Concept, while another may return a representation of properties of a versioned Concept that then needs to be parsed to determine its primitive/fully defined status.

Ref Notes
1 This information is directly discernable from the SCTID itself.