NIH | National Cancer Institute | NCI Wiki  

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • Browser
  • Java
  • Scala
  • Python
  • JavaScript
  • Unix Command line
  • Any platform able to handle REST calls and XML or JSON formatted responses

Browser

Any Browser browser window is a REST client. A User user can type in the REST command and view the resulting XML or otherwise formatted text/JSON. Click on image to expand:

...

We recommend using the free community edition of Intellij

Multiexcerpt include
MultiExcerptNameExitDisclaimer
nopaneltrue
PageWithExcerptwikicontent:Exit Disclaimer to Include
. Download and install the Scala plugin according to the directions. Then follow instructions for creating a Scala project and an object like the following. Change the URL to whatever CTS2 service is available.

Code Block
languagejava
titleScala REST Example
collapsetrue
package mayo.edu.cts2.client.rest.scala

import java.net.{HttpURLConnection, URL}
import io.Source

/**
 * Created with IntelliJ IDEA.
 */
object CTS2RestClient extends App{
  val connection =
    new URL("http://http://lexevscts2.nci.nih.gov/lexevscts2/valuesets").openConnection().asInstanceOf[HttpURLConnection]
  val inputStream = connection.getInputStream
  val src = Source.fromInputStream(inputStream)
  src.getLines().foreach(println)
}

...

Install Python on your system. Create a text file with the .py extension and run with the "python myrestclient.py" command.

Code Block
languagepython
titleSimple Python Rest Client
collapsetrue
__author__ = 'sbauer'
import urllib2

try:
    file = urllib2.urlopen('http://lexevscts2.nci.nih.gov/lexevscts2/resolvedvaluesets')
except urllib2.URLError, e:
    if e.code == 404:
        print("check url")
#     continue to handle other errors here
else:
    print(file.read())

...

Code Block
languagepython
titlePython REST Client
collapsetrue
__author__ = 'sbauer'
from restful_lib import Connection

conn = Connection("http://http://lexevscts2.nci.nih.gov/lexevscts2")
reply = conn.request_get("/valuesets")
if reply['headers']['status'] == '200':
    print reply['body']


conn = Connection("http://http://lexevscts2.nci.nih.gov/lexevscts2")
reply = conn.request_get("/valuesets?format=json",headers={'Accept':'application/json;q=1.0'})
if reply['headers']['status'] == '200':
    print reply['body']
    print eval(reply['body'])

conn = Connection("http://http://lexevscts2.nci.nih.gov/lexevscts2")
print conn.request_get("/valuesets?matchvalue='Sequence'")['body']

JavaScript (JQuery and Bootstrap.js)

Warning

This script example features JSON parsing.  The JSON structure in CTS2 1.0 was non-standard and will not be compatible with the standardized JSON in CTS2 1.1.  CTS2 XML is standard.  CTS2 associated with LexEVS 6.2 will contain the standard version of JSON for CTS 1.1.

 

  • Download JQuery 1.10.x
    Multiexcerpt include
    MultiExcerptNameExitDisclaimer
    nopaneltrue
    PageWithExcerptwikicontent:Exit Disclaimer to Include
    and Bootstrap 3.0.x
    Multiexcerpt include
    MultiExcerptNameExitDisclaimer
    nopaneltrue
    PageWithExcerptwikicontent:Exit Disclaimer to Include
  • Create a CTSRest directory for your files
  • Add directories bootstrap and cts2 to this root
  • Add subdirectories js and css to both directories you've just created
  • Add bootstrap.js to the bootstrap/js directory
  • Add bootstrap.min.css to the bootstrap/css directory
  • Add jquery-1.10.2.js to the cts2/js library
  • Create a codeSystem.js text file and add the following text (adjust the serviceUrl to point to a convenient CTS2 service)

Unix Command Line

returns XML that can be piped to a file

Code Block
languagebash
titleShell Script using Unix curl command
$ curl http://lexevscts2.nci.nih.gov/lexevscts2/codesystemversions

Java Serialization using the CTS2 Framework

CTS2 Framework Serialization snippet

A reference implementation framework in Java includes parsing and marshaling utilities as well as CTS2 model elements in Java to serialize the JSON responses. For example:

Code Block
           JsonConverter converter = new JsonConverter();
            ResolvedValueSetDirectory valuesetdir = converter.fromJson(
            <JSON>, ResolvedValueSetDirectory.class);
Getting the Framework
Note
titleHint

You may have handshake errors running maven against the new SSL enabled repository URL. If so try adjusting Maven Options as follows:

export MAVEN_OPTS="-Dhttps.protocols=TLSv1.1,TLSv1.2 -Dforce.http.jre.executor=true -Xmx3072m -XX:MaxPermSize=752m"

 

The CTS2 Framework and its dependencies are easily pulled in to your Java project via maven using the following elements in the pom.xml file:

Code Block
      <repository>
            <id>nci.maven.releases</id>
Code Block
languagejavascript
titleJavaScript REST Client
collapsetrue
var CodeSystemListConfig = {
    serviceUrl: "http://<base url>/codesystemversions?format=json"
};

function init() {

    $(document).ready(
        function() {
            var<name>NCI urlMaven = CodeSystemListConfig.serviceUrl;Release Repository</name>
            $.getJSON(url + "&callback=?", function (data) {
<url>https://ncimvn.nci.nih.gov/nexus/content/repositories/LexEVSRelease</url>
      </repository>

          for (var i in data.codeSystemVersionCatalogEntryDirectory.entryList) {<dependency>
                    var entry = data.codeSystemVersionCatalogEntryDirectory.entryList[i];<groupId>edu.mayo.cts2.framework</groupId>
                    var key = entry.formalName;<artifactId>cts2-core</artifactId>
                    var designation = entry.documentURI;
                    var uri = entry.href;<version>1.3.3.FINAL</version>
                    $("ul").append("<li><a href=\"" + uri +"\">" + key + "</a></li>");
                }
            });
        });
}
  • when complete add codesystem.js to the cts2/js directory
  • Create a new html file containing the following html and add it to the root CTSRest folder
Code Block
languagehtml/xml
titleHTML
collapsetrue
<!DOCTYPE html>
<html>
<head>
    <title>Code System</title>
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <!-- Bootstrap -->
    <link href="bootstrap/css/bootstrap.min.css" rel="stylesheet" media="screen">
    <script src="cts2/js/codeSystem.js"></script>
    <script src="cts2/js/jquery-1.10.2.js"></script>
</head>
<body>
<h1>Code Systems</h1>
<script>init()</script>
<ul class="nav nav-pills nav-stacked">
    <li class="active"><a href="#">Home</a></li>
</ul>
<script src="bootstrap/js/bootstrap.js"></script>
</body>
</html>
  • Open the new HTML file in a browser and you should see  code systems displayed on a browser page.

Warning
titleTroubleshooting

If this page shows errors in your browser's debugging tools, you may have extraneous characters in your text file. Try removing all indentations, save and run again.

Unix Command Line

returns XML that can be piped to a file

Code Block
languagebash
titleShell Script using Unix curl command
r0223758:~ m029206$ curl http://lexevscts2.nci.nih.gov/lexevscts2/codesystemversions

Java Serialization using the CTS2 Framework

CTS2 Framework Serialization snippet

A reference implementation framework in Java includes parsing and marshaling utilities as well as CTS2 model elements in Java to serialize the JSON responses. For example:

Code Block
           JsonConverter converter = new JsonConverter();
            ResolvedValueSetDirectory valuesetdir = converter.fromJson(
            <JSON>, ResolvedValueSetDirectory.class);
Getting the Framework
Note
titleHint

You may have handshake errors running maven against the new SSL enabled repository URL. If so try adjusting Maven Options as follows:

export MAVEN_OPTS="-Dhttps.protocols=TLSv1.1,TLSv1.2 -Dforce.http.jre.executor=true -Xmx3072m -XX:MaxPermSize=752m"

 

The CTS2 Framework and its dependencies are easily pulled in to your Java project via maven using the following elements in the pom.xml file:

Code Block
      <repository>
            <id>nci.maven.releases</id>
            <name>NCI Maven Release Repository</name>
            <url>https://ncimvn.nci.nih.gov/nexus/content/repositories/LexEVSRelease</url>
      </repository>

      <dependency>
            <groupId>edu.mayo.cts2.framework</groupId>
            <artifactId>cts2-core</artifactId>
            <version>1.3.3.FINAL</version>
      </dependency>

A Mapping of CTS2 REST Calls to CTS2 Framework Model Elements

REST call mappings to CTS2 Model elements in Java

Note
Hint: Resolve as JSON or XML in a browser and use the hierarchy of the document to choose methods to drill down to data on attribute you need. Google Chrome with the JSONView extension installed makes the process for JSON transparent as you can hover over the element and see the call to the object you'll need to make in JavaScript.
Info

Generally returned summary lists are returned as Directories and single elements are returned as messages such as "EntryMsg"

...

<base url>/codesystem/NCI_Thesaurus/version/17.06d

...

CodeSystemVersionCatalogEntryMsg

...

<base url>/resolvedvaluesets?matchvalue=imputation&filtercomponent=resourceName&format=json

...

<base url>/codesystem/NCI_Thesaurus/version/17.06d/entities?format=json

...

<base url>/codesystem/NCI_Thesaurus/version/17.06d/entities?matchvalue=swelling&format=json

...

EntityDescriptionMsg
with an instance entity with method calls:

entity.getEntityDescription().getNamedEntity().getParent()

returning an instance of URIAndEntityName[]

...

<base url>/codesystem/NCI_Thesaurus/version/17.06d/entity/C3399/children?format=json

...

<base url>/codesystem/npo/version/TestForMultiNamespace/entity/GO:NPO_1607/subjectof?format=json

...

<base url>/codesystem/NCI_Thesaurus/version/17.06d/entity/C3399/targetof?format=json

...

<base url>/mapversions?format=json

...

<base url>/map/MA_to_NCIt_Mapping/version/MA_to_NCIt_Mapping-1.0?format=json

...

<base url>/map/MA_to_NCIt_Mapping/version/MA_to_NCIt_Mapping-1.0/entries?format=json

...

<base url>/mapversions?codesystem=ICD10CM&codesystemsmaprole=MAP_TO_ROLE&format=json

...

</dependency>

A Mapping of CTS2 REST Calls to CTS2 Framework Model Elements

REST call mappings to CTS2 Model elements in Java

Note
Hint: Resolve as JSON or XML in a browser and use the hierarchy of the document to choose methods to drill down to data on attribute you need. Google Chrome with the JSONView extension installed makes the process for JSON transparent as you can hover over the element and see the call to the object you'll need to make in JavaScript.
Info

Generally returned summary lists are returned as Directories and single elements are returned as messages such as "EntryMsg"

Info

The following examples show how to have the output formatted to JSON with the "format=json" parameter.  When the format is not specified, it will default to XML.

DescriptionRESTModel Element Class
Code System Versions<base url>codesystemversions?format=jsonCodeSystemVersionCatalogEntryDirectory
Code System Read
<base url>/codesystem/NCI_Thesaurus/version/17.06d
CodeSystemVersionCatalogEntryMsg
Code System Version Query<base url>/codesystemversions?matchvalue=nci_thesaurus&filtercomponent=resourceName&format=jsonCodeSystemVersionCatalogEntryDirectory
Value Sets<base url>resolvedvaluesets?format=jsonResolvedValueSetDirectory
Value Set Definition Read<base url>/cts2/valueset/CDISC ADaM Terminology/definition/5f51c37b?format=jsonValueSetDefinitionMsg
Value Set Query
<base url>/resolvedvaluesets?matchvalue=imputation&filtercomponent=resourceName&format=json
ResolvedValueSetDirectory
Value Set Entries<base url>/valueset/valueset/CDISC Questionnaire Terminology/definition/aa5e7b3f/resolution/1?format=json
IteratableResolvedValueSet
Entities
<base url>/codesystem/NCI_Thesaurus/version/17.06d/entities?format=json
EntityDirectory
Entity Read<base url>/codesystem/NCI_Thesaurus/version/17.06d/entity/C3399?format=jsonEntityDescriptionMsg
Entity Query
<base url>/codesystem/NCI_Thesaurus/version/17.06d/entities?matchvalue=swelling&format=json
EntityDirectory
Association parents<base url>/codesystem/NCI_Thesaurus/version/17.06d/entity/C3399?format=json

EntityDescriptionMsg
with an instance entity with method calls:

entity.getEntityDescription().getNamedEntity().getParent()

returning an instance of URIAndEntityName[]

Association children
<base url>/codesystem/NCI_Thesaurus/version/17.06d/entity/C3399/children?format=json
EntityDirectory
Association subjectOf
<base url>/codesystem/npo/version/TestForMultiNamespace/entity/GO:NPO_1607/subjectof?format=json
AssociationDirectory
Association targetOf
<base url>/codesystem/NCI_Thesaurus/version/17.06d/entity/C3399/targetof?format=json
AssociationDirectory
Maps
<base url>/mapversions?format=json
MapVersionDirectory
Map Version Query<base url>/mapversions?matchvalue=ncit&filtercomponent=resourceSynopsis&format=jsonMapVersionDirectory
Map Version Read
<base url>/map/MA_to_NCIt_Mapping/version/MA_to_NCIt_Mapping-1.0?format=json
MapVersionMsg
Map Entities
<base url>/map/MA_to_NCIt_Mapping/version/MA_to_NCIt_Mapping-1.0/entries?format=json
 MapEntryDirectory 
Map Restriction To, From, or Both Role
<base url>/mapversions?codesystem=ICD10CM&codesystemsmaprole=MAP_TO_ROLE&format=json
MapVersionDirectory
Complete Code Example
Code Block
languagejava
collapsetrue
package cts2.mayo.example;

import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;
import java.util.List;

import edu.mayo.cts2.framework.core.json.JsonConverter;
import edu.mayo.cts2.framework.model.codesystemversion.CodeSystemVersionCatalogEntryDirectory;
import edu.mayo.cts2.framework.model.codesystemversion.CodeSystemVersionCatalogEntrySummary;
import edu.mayo.cts2.framework.model.core.EntitySynopsis;
import edu.mayo.cts2.framework.model.core.URIAndEntityName;
import edu.mayo.cts2.framework.model.entity.EntityDescriptionMsg;
import edu.mayo.cts2.framework.model.entity.EntityDirectory;
import edu.mayo.cts2.framework.model.entity.EntityDirectoryEntry;
import edu.mayo.cts2.framework.model.mapversion.MapVersionDirectory;
import edu.mayo.cts2.framework.model.mapversion.MapVersionDirectoryEntry;
import edu.mayo.cts2.framework.model.valuesetdefinition.IteratableResolvedValueSet;
import edu.mayo.cts2.framework.model.valuesetdefinition.ResolvedValueSetDirectory;
import edu.mayo.cts2.framework.model.valuesetdefinition.ResolvedValueSetDirectoryEntry;

public class RESTFromCTS2Framework {
	String baseUri = "http://lexevscts2.nci.nih.gov/lexevscts2/";
	String format = "?format=json";
	

	public void getValueSets(){

		URL url;
		try {
			url = new URL(baseUri + "resolvedvaluesets" + format);
			HttpURLConnection connection = (HttpURLConnection) url
					.openConnection();
			connection.setRequestProperty("Accept", "text/json");
			if (connection.getResponseCode() != 200) {
				throw new RuntimeException("Failed : The HTTP error code is : "
						+ connection.getResponseCode());
			}
			BufferedReader br = new BufferedReader(new InputStreamReader(
					(connection.getInputStream())));
			String output;
			StringBuilder builder = new StringBuilder();
			while ((output = br.readLine()) != null) {
				builder.append(output);
			}
			JsonConverter converter = new JsonConverter();
			ResolvedValueSetDirectory valuesetdir = converter.fromJson(
					builder.toString(), ResolvedValueSetDirectory.class);
			List<ResolvedValueSetDirectoryEntry> sum = valuesetdir
					.getEntryAsReference();
			for (ResolvedValueSetDirectoryEntry s : sum) {
				System.out.println(s.getResolvedHeader().getResolutionOf()
						.getValueSet().getContent());
			}
		} catch (Exception e) {
			e.printStackTrace();
		}

	}
	
	public void getValueSetEntries(){
		URL url;
		try {
			url = new URL(baseUri + "valueset/NICHD%20Newborn%20Screening%20Terminology/definition/4125c982/resolution/1" 
Complete Code Example
Code Block
languagejava
collapsetrue
package cts2.mayo.example;

import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;
import java.util.List;

import edu.mayo.cts2.framework.core.json.JsonConverter;
import edu.mayo.cts2.framework.model.codesystemversion.CodeSystemVersionCatalogEntryDirectory;
import edu.mayo.cts2.framework.model.codesystemversion.CodeSystemVersionCatalogEntrySummary;
import edu.mayo.cts2.framework.model.core.EntitySynopsis;
import edu.mayo.cts2.framework.model.core.URIAndEntityName;
import edu.mayo.cts2.framework.model.entity.EntityDescriptionMsg;
import edu.mayo.cts2.framework.model.entity.EntityDirectory;
import edu.mayo.cts2.framework.model.entity.EntityDirectoryEntry;
import edu.mayo.cts2.framework.model.mapversion.MapVersionDirectory;
import edu.mayo.cts2.framework.model.mapversion.MapVersionDirectoryEntry;
import edu.mayo.cts2.framework.model.valuesetdefinition.IteratableResolvedValueSet;
import edu.mayo.cts2.framework.model.valuesetdefinition.ResolvedValueSetDirectory;
import edu.mayo.cts2.framework.model.valuesetdefinition.ResolvedValueSetDirectoryEntry;

public class RESTFromCTS2Framework {
	String baseUri = "http://lexevscts2.nci.nih.gov/lexevscts2/";
	String format = "?format=json";
	

	public void getValueSets(){

		URL url;
		try {
			url = new URL(baseUri + "resolvedvaluesets" + format);
			HttpURLConnection connection = (HttpURLConnection) url
					.openConnection();
			connection.setRequestProperty("Accept", "text/json");
			if (connection.getResponseCode() != 200) {
				throw new RuntimeException("Failed : The HTTP error code is : "
						+ connection.getResponseCode());
			}
			BufferedReader br = new BufferedReader(new InputStreamReader(
					(connection.getInputStream())));
			String output;
			StringBuilder builder = new StringBuilder();
			while ((output = br.readLine()) != null) {
				builder.append(output);
			}
			JsonConverter converter = new JsonConverter();
			ResolvedValueSetDirectoryIteratableResolvedValueSet valuesetdir = converter.fromJson(
					builder.toString(), ResolvedValueSetDirectoryIteratableResolvedValueSet.class);
			List<ResolvedValueSetDirectoryEntry>List<EntitySynopsis> sum = valuesetdir
					.getEntryAsReference();
			for (ResolvedValueSetDirectoryEntryEntitySynopsis s : sum) {
				System.out.println(s.getResolvedHeader().getResolutionOf()
						.getValueSet().getContent()getName());
			}
		} catch (Exception e) {
			e.printStackTrace();
		}

	}
	
	public void getValueSetEntriesgetCodeSystems(){

		URL url;
		try {
			url = new URL(baseUri + "valueset/NICHD%20Newborn%20Screening%20Terminology/definition/4125c982/resolution/1codesystemversions" + format);
			HttpURLConnection connection = (HttpURLConnection) url
					.openConnection();
			connection.setRequestProperty("Accept", "text/json");
			if (connection.getResponseCode() != 200) {
				throw new RuntimeException("Failed : The HTTP error code is : "
						+ connection.getResponseCode());
			}
			BufferedReader br = new BufferedReader(new InputStreamReader(
					(connection.getInputStream())));
			String output;
			StringBuilder builder = new StringBuilder();
			while ((output = br.readLine()) != null) {
				builder.append(output);
			}
			JsonConverter converter = new JsonConverter();
			IteratableResolvedValueSetCodeSystemVersionCatalogEntryDirectory valuesetdir = converter.fromJson(
					builder.toString(), IteratableResolvedValueSetCodeSystemVersionCatalogEntryDirectory.class);
			List<EntitySynopsis>List<CodeSystemVersionCatalogEntrySummary> sum = valuesetdir
					.getEntryAsReference();
			for (EntitySynopsisCodeSystemVersionCatalogEntrySummary s : sum) {
				System.out.println(s.getNamegetFormalName());
			}
		} catch (Exception e) {
			e.printStackTrace();
		}

	}
	
	public void getCodeSystemsgetEntities(){

		URL url;
		try {
			url = new URL(baseUri + "codesystemversionscodesystem/NCI_Thesaurus/version/10.10a/entities" + format);
			HttpURLConnection connection = (HttpURLConnection) url
					.openConnection();
			connection.setRequestProperty("Accept", "text/json");
			if (connection.getResponseCode() != 200) {
				throw new RuntimeException("Failed : The HTTP error code is : "
						+ connection.getResponseCode());
			}
			BufferedReader br = new BufferedReader(new InputStreamReader(
					(connection.getInputStream())));
			String output;
			StringBuilder builder = new StringBuilder();
			while ((output = br.readLine()) != null) {
				builder.append(output);
			}
			JsonConverter converter = new JsonConverter();
			CodeSystemVersionCatalogEntryDirectoryEntityDirectory valuesetdir = converter.fromJson(
					builder.toString(), CodeSystemVersionCatalogEntryDirectoryEntityDirectory.class);
			List<CodeSystemVersionCatalogEntrySummary>List<EntityDirectoryEntry> sum = valuesetdir
					.getEntryAsReference();
			for (CodeSystemVersionCatalogEntrySummaryEntityDirectoryEntry s : sum) {
				System.out.println(s.getFormalNamegetName());
			}
		} catch (Exception e) {
			e.printStackTrace();
		}

	}
	
	public void getEntitiesentityReadParent(){
		URL url;
		try {
			url = new URL(baseUri + "codesystem/NCI_Thesaurus/version/10.10a/entitiesentity/C3399" + format);
			HttpURLConnection connection = (HttpURLConnection) url
					.openConnection();
			connection.setRequestProperty("Accept", "text/json");
			if (connection.getResponseCode() != 200) {
				throw new RuntimeException("Failed : The HTTP error code is : "
						+ connection.getResponseCode());
			}
			BufferedReader br = new BufferedReader(new InputStreamReader(
					(connection.getInputStream())));
			String output;
			StringBuilder builder = new StringBuilder();
			while ((output = br.readLine()) != null) {
				builder.append(output);
			}
			JsonConverter converter = new JsonConverter();
			EntityDirectoryEntityDescriptionMsg valuesetdirentity = converter.fromJson(
					builder.toString(), EntityDirectoryEntityDescriptionMsg.class);
			List<EntityDirectoryEntry>URIAndEntityName[] sum = valuesetdir
					.getEntryAsReferenceentity.getEntityDescription().getNamedEntity().getParent();
			for (EntityDirectoryEntryURIAndEntityName s : sum) {
				System.out.println(s.getName());
			}
		} catch (Exception e) {
			e.printStackTrace();
		}
	}
	
	public void entityReadParentgetMaps(){
		URL url;
		try {
			url = new URL(baseUri + "codesystem/NCI_Thesaurus/version/10.10a/entity/C3399mapversions" + format);
			HttpURLConnection connection = (HttpURLConnection) url
					.openConnection();
			connection.setRequestProperty("Accept", "text/json");
			if (connection.getResponseCode() != 200) {
				throw new RuntimeException("Failed : The HTTP error code is : "
						+ connection.getResponseCode());
			}
			BufferedReader br = new BufferedReader(new InputStreamReader(
					(connection.getInputStream())));
			String output;
			StringBuilder builder = new StringBuilder();
			while ((output = br.readLine()) != null) {
				builder.append(output);
			}
			JsonConverter converter = new JsonConverter();
			EntityDescriptionMsgMapVersionDirectory entitymaps = converter.fromJson(
					builder.toString(), EntityDescriptionMsgMapVersionDirectory.class);
			URIAndEntityName[]List<MapVersionDirectoryEntry> sum = entitymaps.getEntityDescriptiongetEntryAsReference().getNamedEntity().getParent();
			for (URIAndEntityNameMapVersionDirectoryEntry s : sum) {
				System.out.println(s.getNamegetFormalName());
			}
		} catch (Exception e) {
			e.printStackTrace();
		}
	}

	/**
	 * @param args
	 */
	public static void getMapsmain(String[] args) {
		URL urlnew RESTFromCTS2Framework().getCodeSystems();
		try {new RESTFromCTS2Framework().getValueSets();
			url = new URL(baseUri + "mapversions" + formatRESTFromCTS2Framework().getEntities();
			HttpURLConnection connection = (HttpURLConnection) url
					.openConnectionnew RESTFromCTS2Framework().entityReadParent();
		new RESTFromCTS2Framework().getMaps();
			connection.setRequestProperty("Accept", "text/json");
			if (connection.getResponseCode() != 200) {
				throw new RuntimeException("Failed : The HTTP error code is : "
						+ connection.getResponseCode());
			}
			BufferedReader br = new BufferedReader(new InputStreamReader(
					(connection.getInputStream())));
			String output;
			StringBuilder builder = new StringBuilder();
			while ((output = br.readLine()) != null) {
				builder.append(output);
			}
			JsonConverter converter = new JsonConverter();
			MapVersionDirectory maps = converter.fromJson(
					builder.toString(), MapVersionDirectory.class);
			List<MapVersionDirectoryEntry> sum = maps.getEntryAsReference();
			for (MapVersionDirectoryEntry s : sum) {
				System.out.println(s.getFormalName());
			}
		} catch (Exception e) {
			e.printStackTrace();
		}
	}

	/**
	 * @param args
	 */
	public static void main(String[] args) {
		new RESTFromCTS2Framework().getCodeSystems();
		new RESTFromCTS2Framework().getValueSets();
		new RESTFromCTS2Framework().getEntities();
		new RESTFromCTS2Framework().entityReadParent();
		new RESTFromCTS2Framework().getMaps();
		new RESTFromCTS2Framework().getValueSetEntries();
	}
}

Other Development Platforms

REST Clients can be built on PHP, Perl and C# as well.

examples

Multiexcerpt include
MultiExcerptNameExitDisclaimer
nopaneltrue
PageWithExcerptwikicontent:Exit Disclaimer to Include

Code System

Getting All CodeSystemCatalogVersions Summaries

Returns a set of CodeSystemVersions

Code Block
http://<base url>/codesystemversions?maxtoreturn=5&format=json

Output

new RESTFromCTS2Framework().getValueSetEntries();
	}
}

Other Development Platforms

REST Clients can be built on PHP, Perl and C# as well.

examples

Multiexcerpt include
MultiExcerptNameExitDisclaimer
nopaneltrue
PageWithExcerptwikicontent:Exit Disclaimer to Include

Code System

Getting All CodeSystemCatalogVersions Summaries

Returns a set of CodeSystemVersions.

Code Block
http://<base url>/codesystemversions?maxtoreturn=5&format=json

Output

Code Block
collapsetrue
{

    "CodeSystemVersionCatalogEntryDirectory": {
        "entry": [
            {
                "codeSystemVersionName": "MDR-13.0",
                "versionOf": {
                    "content": "MDR",
                    "uri": "urn:oid:2.16.840.1.113883.6.163"
                },
                "documentURI": "urn:oid:2.16.840.1.113883.6.163:13.0",
Code Block
collapsetrue
{

    "CodeSystemVersionCatalogEntryDirectory": {
        "entry": [
            {"officialResourceVersionId": "13.0",
                "codeSystemVersionNameabout": "MDR-urn:oid:2.16.840.1.113883.6.163:13.0",
                "versionOfformalName": {
"MedDRA (Medical Dictionary for Regulatory Activities Terminology)",
                "contentresourceSynopsis": "MDR",{
                    "urivalue": "urn:oid:2.16.840.1.113883.6.163MedDRA (Medical Dictionary for Regulatory Activities Terminology)"
                },
                "documentURI": "urn:oid:2.16.840.1.113883.6.163:13.0",
                "officialResourceVersionId": "13.0",
                "about": "urn:oid:2.16.840.1.113883.6.163:13.0",
                "formalName": "MedDRA (Medical Dictionary for Regulatory Activities Terminology)",
                "resourceSynopsis": {
                    "value": "MedDRA (Medical Dictionary for Regulatory Activities Terminology)"
                },
                "href": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/MDR/version/13.0"
            },
            {
                "codeSystemVersionName": "MDR-13.1",
                "versionOf": {
                    "content": "MDR",
                    "uri": "urn:oid:2.16.840.1.113883.6.163"
                },
                "documentURI": "urn:oid:2.16.840.1.113883.6.163:13.1",
                "officialResourceVersionId": "13.1",
                "about": "urn:oid:2.16.840.1.113883.6.163:13.1",
                "formalName": "MedDRA (Medical Dictionary for Regulatory Activities Terminology)",
                "resourceSynopsis": {
                    "value": "MedDRA (Medical Dictionary for Regulatory Activities Terminology)"
                },
                "href": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/MDR/version/13.1"
            },
            {
                "codeSystemVersionName": "MDR-15.0",
                "versionOf": {
                    "content": "MDR",
                    "uri": "urn:oid:2.16.840.1.113883.6.163"
                },
                "documentURI": "urn:oid:2.16.840.1.113883.6.163:15.0",
                "officialResourceVersionId": "15.0",
                "about": "urn:oid:2.16.840.1.113883.6.163:15.0",
                "formalName": "MedDRA (Medical Dictionary for Regulatory Activities Terminology)",
                "resourceSynopsis": {
                    "value": "MedDRA (Medical Dictionary for Regulatory Activities Terminology)"
                },
                "href": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/MDR/version/15.0"
            },
            {
                "codeSystemVersionName": "MDR-14.1",
                "versionOf": {
                    "content": "MDR",
                    "uri": "urn:oid:2.16.840.1.113883.6.163"
                },
                "documentURI": "urn:oid:2.16.840.1.113883.6.163:14.1",
                "officialResourceVersionId": "14.1",
                "about": "urn:oid:2.16.840.1.113883.6.163:14.1",
                "formalName": "MedDRA (Medical Dictionary for Regulatory Activities Terminology)",
                "resourceSynopsis": {
                    "value": "MedDRA (Medical Dictionary for Regulatory Activities Terminology)"
                },
                "href": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/MDR/version/14.1"
            },
            {
                "codeSystemVersionName": "MDR-15.1",
                "versionOf": {
                    "content": "MDR",
                    "uri": "urn:oid:2.16.840.1.113883.6.163"
                },
                "documentURI": "urn:oid:2.16.840.1.113883.6.163:15.1",
                "officialResourceVersionId": "15.1",
                "about": "urn:oid:2.16.840.1.113883.6.163:15.1",
                "formalName": "MedDRA (Medical Dictionary for Regulatory Activities Terminology)",
                "resourceSynopsis": {
                    "value": "MedDRA (Medical Dictionary for Regulatory Activities Terminology)"
                },
                "href": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/MDR/version/15.1"
            }
        ],
        "complete": "PARTIAL",
        "numEntries": 5,
        "next": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystemversions?page=1&format=json&maxtoreturn=5",
        "heading": {
            "resourceRoot": "https://lexevscts2.nci.nih.gov/lexevscts2/",
            "resourceURI": "codesystemversions",
            "parameter": [
                {
                    "arg": "maxtoreturn",
                    "val": "5"
                },
                {
                    "arg": "format",
                    "val": "json"
                }
            ],
            "accessDate": "2017-08-04T16:20:07.172-04:00"
        }
    }

}

...

Returns a set of CodeSystemVersions based on a text match.

Code Block
http://<base url>/codesystemversions?matchvalue=nci_thesaurus&filtercomponent=resourceName&format=json

Output

Code Block
collapsetrue
{

    "CodeSystemVersionCatalogEntryDirectory": {
        "entry": [
            {
                "codeSystemVersionName": "NCI_Thesaurus-17.02d",
                "versionOf": {
                    "content": "NCI_Thesaurus",
                    "uri": "http://ncicb.nci.nih.gov/xml/owl/EVS/Thesaurus.owl#"
                },
                "documentURI": "http://ncicb.nci.nih.gov/xml/owl/EVS/Thesaurus.owl#17.02d",
                "officialResourceVersionId": "17.02d",
                "about": "http://ncicb.nci.nih.gov/xml/owl/EVS/Thesaurus.owl#17.02d",
                "formalName": "NCI Thesaurus",
                "resourceSynopsis": {
                    "value": "NCI Thesaurus"
                },
                "href": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurus/version/17.02d"
            },
            {
                "codeSystemVersionName": "NCI_Thesaurus-17.03d",
                "versionOf": {
                    "content": "NCI_Thesaurus",
                    "uri": "http://ncicb.nci.nih.gov/xml/owl/EVS/Thesaurus.owl#"
                },
                "documentURI": "http://ncicb.nci.nih.gov/xml/owl/EVS/Thesaurus.owl#17.03d",
                "officialResourceVersionId": "17.03d",
                "about": "http://ncicb.nci.nih.gov/xml/owl/EVS/Thesaurus.owl#17.03d",
                "formalName": "NCI Thesaurus",
                "resourceSynopsis": {
                    "value": "NCI Thesaurus"
                },
                "href": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurus/version/17.03d"
            },
            {
                "codeSystemVersionName": "NCI_Thesaurus-17.04d",
                "versionOf": {
                    "content": "NCI_Thesaurus",
                    "uri": "http://ncicb.nci.nih.gov/xml/owl/EVS/Thesaurus.owl#"
                },
                "documentURI": "http://ncicb.nci.nih.gov/xml/owl/EVS/Thesaurus.owl#17.04d",
                "officialResourceVersionId": "17.04d",
                "about": "http://ncicb.nci.nih.gov/xml/owl/EVS/Thesaurus.owl#17.04d",
                "formalName": "NCI Thesaurus",
                "resourceSynopsis": {
                    "value": "NCI Thesaurus"
                },
                "href": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurus/version/17.04d"
            },
            {
                "codeSystemVersionName": "NCI_Thesaurus-17.06d",
                "versionOf": {
                    "content": "NCI_Thesaurus",
                    "uri": "http://ncicb.nci.nih.gov/xml/owl/EVS/Thesaurus.owl#"
                },
                "documentURI": "http://ncicb.nci.nih.gov/xml/owl/EVS/Thesaurus.owl#17.06d",
                "officialResourceVersionId": "17.06d",
                "about": "http://ncicb.nci.nih.gov/xml/owl/EVS/Thesaurus.owl#17.06d",
                "formalName": "NCI Thesaurus",
                "resourceSynopsis": {
                    "value": "NCI Thesaurus"
                },
                "href": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurus/version/17.06d"
            }
        ],
        "complete": "COMPLETE",
        "numEntries": 4,
        "heading": {
            "resourceRoot": "https://lexevscts2.nci.nih.gov/lexevscts2/",
            "resourceURI": "codesystemversions",
            "parameter": [
                {
                    "arg": "matchvalue",
                    "val": "nci_thesaurus"
                },
                {
                    "arg": "filtercomponent",
                    "val": "resourceName"
                },
                {
                    "arg": "format",
                    "val": "json"
                }
            ],
            "accessDate": "2017-08-04T16:23:29.829-04:00"
        }
    }

}

...

Code Block
http://<base url>/codesystem/NCI_Thesaurus/version/17.06d/entities?maxtoreturn=250&format=json

Output

Code Block
collapsetrue
{

    "EntityDirectory": {
        "entry": [
            {
                "about": "http://ncicb.nci.nih.gov/xml/owl/EVS/NCI_Thesaurus.owl#C14722",
                "name": {
                    "namespace": "NCI_Thesaurus",
                    "name": "C14722"
                },
                "knownEntityDescription": [
                    {
                        "href": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurus/version/17.06d/entity/C14722",
                        "describingCodeSystemVersion": {
                            "version": {
                                "content": "NCI_Thesaurus-17.06d",
                                "href": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurus/version/17.06d"
                            },
                            "codeSystem": {
                                "content": "NCI_Thesaurus",
                                "uri": "http://ncicb.nci.nih.gov/xml/owl/EVS/Thesaurus.owl#"
                            }
                        },
                        "designation": "Other Inbred Strains"
                    }
                ]
            },
            {
                "about": "http://ncicb.nci.nih.gov/xml/owl/EVS/NCI_Thesaurus.owl#C422",
                "name": {
                    "namespace": "NCI_Thesaurus",
                    "name": "C422"
                },
                "knownEntityDescription": [
                    {
                        "href": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurus/version/17.06d/entity/C422",
                        "describingCodeSystemVersion": {
                            "version": {
                                "content": "NCI_Thesaurus-17.06d",
                                "href": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurus/version/17.06d"
                            },
                            "codeSystem": {
                                "content": "NCI_Thesaurus",
                                "uri": "http://ncicb.nci.nih.gov/xml/owl/EVS/Thesaurus.owl#"
                            }
                        },
                        "designation": "Dexamethasone"
                    }
                ]
            }
        ],
        "complete": "PARTIAL",
        "numEntries": 2,
        "next": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurus/version/17.06d/entities?page=1&format=json&maxtoreturn=2",
        "heading": {
            "resourceRoot": "https://lexevscts2.nci.nih.gov/lexevscts2/",
            "resourceURI": "codesystem/NCI_Thesaurus/version/17.06d/entities",
            "parameter": [
                {
                    "arg": "maxtoreturn",
                    "val": "2"
                },
                {
                    "arg": "format",
                    "val": "json"
                }
            ],
            "accessDate": "2017-08-04T16:32:47.760-04:00"
        }
    }

}

...

  • restrict by codesystem
    http://<Rest Service base URL>/codesystem/LOINCNCI_Thesaurus/version/23217.06d/entities?matchvalue=finger&format=json
    http://<Rest Service base URL>/entities?matchvalue=finger&codesystemversion=LOINC-232NCI_Thesaurus-17.06d&format=json
  • filter 'startsWith'
    http://<Rest Service base URL>/codesystem/LOINCNCI_Thesaurus/version/23217.06d/entities?matchvalue=fingerheart&matchalgorithm=startsWith&format=json
  • filter 'startsWith', restriction to 'CURRENT' version
    http:// <Rest Service base URL> /codesystem/LOINCNCI_Thesaurus/entities?matchalgorithm=startsWith&matchvalue=heartGentamicin&matchalgorithmformat=startsWithjson
  • filter 'contains'
    http://<Rest Service base URL>/entities?matchvalue=heart&matchalgorithm=contains&format=json
    http://<Rest Service base URL>/codesystem/LOINCNCI_Thesaurus/version/232NCI_Thesaurus-17.06d/entities?matchalgorithm=contains&matchvalue=fingerGentamicin&matchalgorithmformat=containsjson
  • filter 'exactMatch'
    http:// <Rest Service base URL> /codesystem/NCI_Thesaurus/version/10.10aNCI_Thesaurus-17.06d/entities?matchalgorithm=exactMatch&matchvalue=swelling&matchalgorithmformat=exactMatchjson

Associations

Associations: Parents

...

Output

Code Block
collapsetrue
{
    "EntityDescriptionMsg": {
        "entityDescription": {
            "namedEntity": {
                "entryState": "ACTIVE",
                "about": "http://ncicb.nci.nih.gov/xml/owl/EVS/NCI_Thesaurus.owl#C3399",
                "entityID": {
                    "namespace": "NCI_Thesaurus",
                    "name": "C3399"
                },
                "describingCodeSystemVersion": {
                    "version": {
                        "content": "NCI_Thesaurus-17.06d",
                        "href": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurus/version/17.06d"
                    },
                    "codeSystem": {
                        "content": "NCI_Thesaurus",
                        "uri": "http://ncicb.nci.nih.gov/xml/owl/EVS/Thesaurus.owl#"
                    }
                },
                "designation": [
                    {
                        "designationRole": "ALTERNATIVE",
                        "assertedInCodeSystemVersion": "NCI",
                        "value": "Swelling",
                        "language": {
                            "content": "en"
                        }
                    },
                    {
                        "designationRole": "ALTERNATIVE",
                        "assertedInCodeSystemVersion": "FDA",
                        "value": "Swelling",
                        "language": {
                            "content": "en"
                        }
                    },
                    {
                        "designationRole": "PREFERRED",
                        "value": "Swelling",
                        "language": {
                            "content": "en"
                        }
                    }
                ],
                "definition": [
                    {
                        "definitionRole": "NORMATIVE",
                        "value": "Enlargement; expansion in size; sign of inflammation"
                    }
                ],
                "property": [
                    {
                        "predicate": {
                            "uri": "http://lexgrid.org/definition-preferred",
                            "namespace": "NCI_Thesaurus",
                            "name": "DEFINITION"
                        },
                        "value": [
                            {
                                "literal": {
                                    "value": "Enlargement; expansion in size; sign of inflammation"
                                }
                            }
                        ],
                        "propertyQualifier": [
                            {
                                "predicate": {
                                    "uri": "http://lexgrid.org/property-source",
                                    "namespace": "lexgrid",
                                    "name": "property-source"
                                },
                                "value": [
                                    {
                                        "literal": {
                                            "value": "NCI"
                                        }
                                    }
                                ]
                            }
                        ]
                    },
                    {
                        "predicate": {
                            "uri": "http://lexgrid.org/presentation-alternate",
                            "namespace": "NCI_Thesaurus",
                            "name": "FULL_SYN"
                        },
                        "value": [
                            {
                                "literal": {
                                    "value": "Swelling"
                                }
                            }
                        ],
                        "propertyQualifier": [
                            {
                                "predicate": {
                                    "uri": "http://lexgrid.org/representational-form",
                                    "namespace": "lexgrid",
                                    "name": "representational-form"
                                },
                                "value": [
                                    {
                                        "literal": {
                                            "value": "PT"
                                        }
                                    }
                                ]
                            },
                            {
                                "predicate": {
                                    "uri": "http://lexgrid.org/property-source",
                                    "namespace": "lexgrid",
                                    "name": "property-source"
                                },
                                "value": [
                                    {
                                        "literal": {
                                            "value": "NCI"
                                        }
                                    }
                                ]
                            }
                        ]
                    },
                    {
                        "predicate": {
                            "uri": "http://lexgrid.org/presentation-alternate",
                            "namespace": "NCI_Thesaurus",
                            "name": "FULL_SYN"
                        },
                        "value": [
                            {
                                "literal": {
                                    "value": "Swelling"
                                }
                            }
                        ],
                        "propertyQualifier": [
                            {
                                "predicate": {
                                    "uri": "http://lexgrid.org/representational-form",
                                    "namespace": "lexgrid",
                                    "name": "representational-form"
                                },
                                "value": [
                                    {
                                        "literal": {
                                            "value": "PT"
                                        }
                                    }
                                ]
                            },
                            {
                                "predicate": {
                                    "uri": "http://ncicb.nci.nih.gov/xml/owl/EVS/Thesaurus.owl#source-code",
                                    "namespace": "NCI_Thesaurus",
                                    "name": "source-code"
                                },
                                "value": [
                                    {
                                        "literal": {
                                            "value": "2091"
                                        }
                                    }
                                ]
                            },
                            {
                                "predicate": {
                                    "uri": "http://ncicb.nci.nih.gov/xml/owl/EVS/Thesaurus.owl#subsource-name",
                                    "namespace": "NCI_Thesaurus",
                                    "name": "subsource-name"
                                },
                                "value": [
                                    {
                                        "literal": {
                                            "value": "CDRH"
                                        }
                                    }
                                ]
                            },
                            {
                                "predicate": {
                                    "uri": "http://lexgrid.org/property-source",
                                    "namespace": "lexgrid",
                                    "name": "property-source"
                                },
                                "value": [
                                    {
                                        "literal": {
                                            "value": "FDA"
                                        }
                                    }
                                ]
                            }
                        ]
                    },
                    {
                        "predicate": {
                            "uri": "http://lexgrid.org/presentation-preferred",
                            "namespace": "NCI_Thesaurus",
                            "name": "Preferred_Name"
                        },
                        "value": [
                            {
                                "literal": {
                                    "value": "Swelling"
                                }
                            }
                        ]
                    },
                    {
                        "predicate": {
                            "uri": "http://ncicb.nci.nih.gov/xml/owl/EVS/Thesaurus.owl#Contributing_Source",
                            "namespace": "NCI_Thesaurus",
                            "name": "Contributing_Source"
                        },
                        "value": [
                            {
                                "literal": {
                                    "value": "FDA"
                                }
                            }
                        ]
    "EntityDescriptionMsg": {
               "entityDescription": {
 },
                 "namedEntity":   {
                        "entryStatepredicate": "ACTIVE",{
                "about            "uri": "http://ncicb.nci.nih.gov/xml/owl/EVS/NCI_Thesaurus.owl#C3399owl#FDA_Table",
                 "entityID           "namespace": {
"NCI_Thesaurus",
                            "namespacename": "NCIFDA_Thesaurus"Table"
                        },
                        "namevalue": "C3399"
[
                     },       {
                "describingCodeSystemVersion                "literal": {
                         "version": {
           "value": "Patient Code (Appendix B)"
                                 "content": "NCI_Thesaurus-17.06d",}
                            }
                        "href": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurus/version/17.06d"]
                    },
                    "codeSystem": {
                        "contentpredicate": "NCI_Thesaurus",
{
                            "uri": "http://ncicb.nci.nih.gov/xml/owl/EVS/Thesaurus.owl#owl#Legacy_Concept_Name",
                    }
        "namespace": "NCI_Thesaurus",
            },
                "designationname": [
"Legacy_Concept_Name"
                     {   },
                        "designationRolevalue": "ALTERNATIVE",[
                        "assertedInCodeSystemVersion": "NCI",
   {
                     "value": "Swelling",
          "literal": {
             "language": {
                            "contentvalue": "enSwelling"
                        }
        }
            },
                    {}
                        "designationRole": "ALTERNATIVE",]
                        "assertedInCodeSystemVersion": "FDA"},
                        "value": "Swelling",{
                        "languagepredicate": {
                            "contenturi": "en"
                        }
       http://ncicb.nci.nih.gov/xml/owl/EVS/Thesaurus.owl#Semantic_Type",
             },
               "namespace": "NCI_Thesaurus",
    {
                        "designationRolename": "PREFERREDSemantic_Type",
                        "value": "Swelling"},
                        "languagevalue": {[
                            "content": "en"{
                        }
                "literal": {
    }
                ],
                "definitionvalue": [
"Sign or Symptom"
                  {
                        "definitionRole": "NORMATIVE",}
                        "value": "Enlargement; expansion in size; sign of inflammation" }
                    }
     ]
           ],
                "property": [},
                    {
                        "predicate": {
                            "uri": "http://lexgrid.org/definition-preferredncicb.nci.nih.gov/xml/owl/EVS/Thesaurus.owl#UMLS_CUI",
                            "namespace": "NCI_Thesaurus",
                            "name": "DEFINITIONUMLS_CUI"
                        },
                        "value": [
                            {
                                "literal": {
                                    "value": "Enlargement; expansion in size; sign of inflammation"
"C0038999"
                                }
                            }
                        ]
                    },
                    }{
                        "predicate": {
     }
                        ],
"uri": "http://ncicb.nci.nih.gov/xml/owl/EVS/Thesaurus.owl#code",
                            "propertyQualifiernamespace": [
"NCI_Thesaurus",
                             {"name": "code"
                        },
        "predicate": {
                "value": [
                       "uri": "http://lexgrid.org/property-source",
    {
                                "namespaceliteral": "lexgrid",{
                                    "namevalue": "property-sourceC3399"
                                },
                                "value": [}
                        ]
            {
        },
                    {
            "literal": {
           "predicate": {
                                "valueuri": "NCI"http://ncicb.nci.nih.gov/xml/owl/EVS/Thesaurus.owl#label",
                            "namespace": "NCI_Thesaurus",
           }
                 "name": "label"
                  }
      },
                          ]"value": [
                            }{
                        ]
        "literal": {
           },
                    {
     "value": "Swelling"
                  "predicate": {
              }
              "uri": "http://lexgrid.org/presentation-alternate",
              }
              "namespace": "NCI_Thesaurus",
         ]
                   "name": "FULL_SYN" }
                ],
        },
        "subjectOf": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurus/version/17.06d/entity/C3399/subjectof",
                "valuetargetOf": ["https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurus/version/17.06d/entity/C3399/targetof",
                "parent": [
           {
         {
                        "literaluri": {"http://ncicb.nci.nih.gov/xml/owl/EVS/NCI_Thesaurus.owl#C53458",
                        "href": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurus/version/17.06d/entity/C53458",
                        "valuenamespace": "SwellingNCI_Thesaurus",
                        "name": "C53458"
       }
             }
               }
 ],
                "children": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurus/version/17.06d/entity/C3399/children",
             ],
   "entityType": [
                    "propertyQualifier": [{
                            {"uri": "http://www.w3.org/2002/07/owl#Class",
                        "namespace": "owl",
       "predicate": {
                "name": "Class"
                   "uri": "http://lexgrid.org/representational-form", }
                ]
            }
        "namespace": "lexgrid"},
        "heading": {
               "resourceRoot": "https://lexevscts2.nci.nih.gov/lexevscts2/",
            "nameresourceURI": "representational-form"codesystem/NCI_Thesaurus/version/17.06d/entity/C3399",
            "parameter": [
                {
   },
                 "arg": "format",
              "value": [
     "val": "json"
                }
              {],
            "accessDate": "2017-08-04T17:17:24.701-04:00"
        }
       }

}

Associations: Children

Returns all the children of the designated entity.

Code Block
http://<base url>/codesystem/NCI_Thesaurus/version/17.06d/entity/C3399/children?format=json

Output

Code Block
collapsetrue
{
            "literal"EntityDirectory": {
        "entry": [
            {
                       "value"about": "PT"http://ncicb.nci.nih.gov/xml/owl/EVS/NCI_Thesaurus.owl#C34569",
                "name": {
                    "namespace": "NCI_Thesaurus",
  }
                  "name": "C34569"
                 },
                "knownEntityDescription": [
                ]
    {
                        }"href": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurus/version/17.06d/entity/C34569",
                            "describingCodeSystemVersion": {
                                "predicateversion": {
                                    "uricontent": "http://lexgrid.org/property-sourceNCI_Thesaurus-17.06d",
                                    "namespacehref": "lexgrid",https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurus/version/17.06d"
                                    "name": "property-source"},
                                },"codeSystem": {
                                "valuecontent": [
"NCI_Thesaurus",
                                     {"uri": "http://ncicb.nci.nih.gov/xml/owl/EVS/Thesaurus.owl#"
                                 }
       "literal": {
                },
                            "valuedesignation": "NCIElephantiasis"
                    }
                ]
    }
        },
            {
                 }"about": "http://ncicb.nci.nih.gov/xml/owl/EVS/NCI_Thesaurus.owl#C3002",
                "name": {
               ]
     "namespace": "NCI_Thesaurus",
                      }"name": "C3002"
                        ]},
                    },"knownEntityDescription": [
                    {
                        "predicatehref": {
    "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurus/version/17.06d/entity/C3002",
                        "uridescribingCodeSystemVersion": "http://lexgrid.org/presentation-alternate",{
                            "namespaceversion": "NCI_Thesaurus",
{
                                "namecontent": "FULL_SYN"NCI_Thesaurus-17.06d",
                        },
                        "value": ["href": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurus/version/17.06d"
                            {
    },
                            "literalcodeSystem": {
                                    "valuecontent": "SwellingNCI_Thesaurus",
                                }"uri": "http://ncicb.nci.nih.gov/xml/owl/EVS/Thesaurus.owl#"
                            }
                        ]},
                        "propertyQualifierdesignation": [
"Edema"
                    }
            {
    ]
            }
        ],
        "predicatecomplete": {"COMPLETE",
        "numEntries": 2,
        "heading": {
            "resourceRoot": "https://lexevscts2.nci.nih.gov/lexevscts2/",
     "uri       "resourceURI": "http:codesystem//lexgrid.org/representational-formNCI_Thesaurus/version/17.06d/entity/C3399/children",
            "parameter": [
                {
       "namespace": "lexgrid",
               "arg": "format",
                     "nameval": "representational-formjson"
                }
            ],
    },
        "accessDate": "2017-08-04T17:18:44.257-04:00"
        }
    }

}

Associations: SubjectOf

Returns all entities that are the subject of an association with this entity.

Code Block
http://<base url>/codesystem/NCI_Thesaurus/version/17.06d/entity/C3399/subjectof?format=json

Output

Code Block
collapsetrue
{

    "AssociationDirectory": {
          "valueentry": [
            {
                        "subject": {
                                        "literal": {"uri": "http://ncicb.nci.nih.gov/xml/owl/EVS/NCI_Thesaurus.owl#C3399",
                        "href": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurus/version/17.06d/entity/C3399",
                    "valuenamespace": "PTNCI_Thesaurus",
                        "name": "C3399"
                },
                "predicate": {
                   }
 "uri": "http://ncicb.nci.nih.gov/xml/owl/EVS/NCI_Thesaurus.owl#A8",
                    "name": "Concept_In_Subset"
         ]
       },
                     },"target": {
                            {
      "entity": {
                          "predicateuri": {
  "http://ncicb.nci.nih.gov/xml/owl/EVS/NCI_Thesaurus.owl#C62596",
                                  "uri"href": "httphttps://ncicblexevscts2.nci.nih.gov/lexevscts2/xmlcodesystem/owlNCI_Thesaurus/EVSversion/Thesaurus.owl#source-code17.06d/entity/C62596",
                                    "namespace": "NCI_Thesaurus",
                        "name": "C62596"
           "name": "source-code"
         }
                },
                 },"assertedBy": {
                    "version": {
            "value": [
            "content": "NCI_Thesaurus-17.06d",
                         {"href": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurus/version/17.06d"
                    },
                    "literalcodeSystem": {
                        "content": "NCI_Thesaurus",
                        "valueuri": "2091http://ncicb.nci.nih.gov/xml/owl/EVS/Thesaurus.owl#"
                    }
                }
            },
            {
                "subject": {
             }
       "uri": "http://ncicb.nci.nih.gov/xml/owl/EVS/NCI_Thesaurus.owl#C62596",
                         ]"href": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurus/version/17.06d/entity/C62596",
                            }"namespace": "NCI_Thesaurus",
                            {"name": "C62596"
                },
                "predicate": {
                                    "uri": "http://ncicb.nci.nih.gov/xml/owl/EVS/NCI_Thesaurus.owl#subsource-nameowl#A8",
                    "name": "Concept_In_Subset"
               "namespace": "NCI_Thesaurus" },
                "target": {
                    "nameentity": "subsource-name"{
                        "uri": "http://ncicb.nci.nih.gov/xml/owl/EVS/NCI_Thesaurus.owl#C54450",
       },
                 "href": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurus/version/17.06d/entity/C54450",
                "value        "namespace": ["NCI_Thesaurus",
                        "name": "C54450"
           {
         }
                },
                "literalassertedBy": {
                    "version": {
                        "valuecontent": "CDRH"
NCI_Thesaurus-17.06d",
                        "href": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurus/version/17.06d"
                    },
          }
          "codeSystem": {
                         }"content": "NCI_Thesaurus",
                                ]
  "uri": "http://ncicb.nci.nih.gov/xml/owl/EVS/Thesaurus.owl#"
                          },
                }
            {},
               {
                 "predicatesubject": {
                                    "uri": "http://lexgrid.org/property-sourcencicb.nci.nih.gov/xml/owl/EVS/NCI_Thesaurus.owl#C54450",
                    "href": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurus/version/17.06d/entity/C54450",
                    "namespace": "lexgridNCI_Thesaurus",
                                    "name": "property-sourceC54450"
                },
                 },"predicate": {
                                "value": ["uri": "http://www.w3.org/2000/01/rdf-schema#subClassOf",
                    "name": "subClassOf"
                {},
                "target": {
                    "entity": {
    "literal": {
                   "uri": "http://ncicb.nci.nih.gov/xml/owl/EVS/NCI_Thesaurus.owl#C53458",
                        "valuehref": "FDA"https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurus/version/17.06d/entity/C53458",
                        "namespace": "NCI_Thesaurus",
               }
         "name": "C53458"
                          }
                },
                ]"assertedBy": {
                    "version": {
       }
                 "content": "NCI_Thesaurus-17.06d",
      ]
                    },"href": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurus/version/17.06d"
                    {},
                        "predicatecodeSystem": {
                            "uricontent": "http://lexgrid.org/presentation-preferredNCI_Thesaurus",
                            "namespaceuri": "NCI_Thesaurus",http://ncicb.nci.nih.gov/xml/owl/EVS/Thesaurus.owl#"
                    }
        "name": "Preferred_Name"
       }
                 },
              ],
          "valuecomplete": ["COMPLETE",
             "numEntries": 3,
        "heading": {
      {
      "resourceRoot": "https://lexevscts2.nci.nih.gov/lexevscts2/",
            "resourceURI": "codesystem/NCI_Thesaurus/version/17.06d/entity/C3399/subjectof",
            "literalparameter": {[
                {
                    "valuearg": "Swellingformat",
                    "val": "json"
           }
     }
            ],
           }
 "accessDate": "2017-08-04T17:19:36.589-04:00"
        }
    }

}

Associations: TargetOf

Returns all entities that are the target of this entity in an association.

Code Block
http://<base url>/codesystem/NCI_Thesaurus/version/17.06d/entity/C3399/targetof?maxtoreturn=5&format=json

Output

Code Block
collapsetrue
{
    "AssociationDirectory": {
    ]
    "entry": [
               },{
                    "subject": {
                        "predicateuri": {"http://ncicb.nci.nih.gov/xml/owl/EVS/NCI_Thesaurus.owl#C3399",
                            "uri"href": "httphttps://ncicblexevscts2.nci.nih.gov/xml/owl/EVS/Thesaurus.owl#Contributing_Source/lexevscts2/codesystem/NCI_Thesaurus/version/17.06d/entity/C3399",
                            "namespace": "NCI_Thesaurus",
                            "name": "Contributing_SourceC3399"
                },
        },
        "predicate": {
               "value": [
    "uri": "http://ncicb.nci.nih.gov/xml/owl/EVS/NCI_Thesaurus.owl#R108",
                       {"name": "Disease_Has_Finding"
                },
                "literaltarget": {
                    "entity": {
               "value": "FDA"
        "uri": "http://ncicb.nci.nih.gov/xml/owl/EVS/NCI_Thesaurus.owl#@75fee354830c997d4bc0e128e16aec09",
                       }
 "href": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurus/version/17.06d/entity/@75fee354830c997d4bc0e128e16aec09",
                        "namespace":  }
"NCI_Thesaurus",
                         ]"name": "@75fee354830c997d4bc0e128e16aec09"
                    },
                    {},
                        "predicate"assertedBy": {
                            "uriversion": "http://ncicb.nci.nih.gov/xml/owl/EVS/Thesaurus.owl#FDA_Table",
    {
                        "namespacecontent": "NCI_ThesaurusThesaurus-17.06d",
                            "namehref": "FDA_Tablehttps://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurus/version/17.06d"
                        },
                        "valuecodeSystem": [{
                            {"content": "NCI_Thesaurus",
                        "uri": "http://ncicb.nci.nih.gov/xml/owl/EVS/Thesaurus.owl#"
       "literal": {
            }
                }
        "value": "Patient Code (Appendix B)" },
            {
                    }"subject": {
                    "uri": "http://ncicb.nci.nih.gov/xml/owl/EVS/NCI_Thesaurus.owl#@75fee354830c997d4bc0e128e16aec09",
       }
             "href": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurus/version/17.06d/entity/@75fee354830c997d4bc0e128e16aec09",
          ]
          "namespace": "NCI_Thesaurus",
         },
           "name": "@75fee354830c997d4bc0e128e16aec09"
        {
        },
                "predicate": {
                            "uri": "http://ncicb.nci.nih.gov/xml/owl/EVS/Thesaurus.owl#Legacy_Concept_Name",NCI_Thesaurus.owl#R108",
                    "name": "Disease_Has_Finding"
                },
                "namespacetarget": "NCI_Thesaurus",
 {
                           "name"entity": "Legacy_Concept_Name"{
                        }"uri": "http://ncicb.nci.nih.gov/xml/owl/EVS/NCI_Thesaurus.owl#C27477",
                        "valuehref": ["https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurus/version/17.06d/entity/C27477",
                            {
  "namespace": "NCI_Thesaurus",
                              "literal"name": {"C27477"
                    }
                "value": "Swelling"
},
                "assertedBy": {
                  }
  "version": {
                         }"content": "NCI_Thesaurus-17.06d",
                        ]"href": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurus/version/17.06d"
                    },
                    "codeSystem": {
                        "predicatecontent": {
    "NCI_Thesaurus",
                        "uri": "http://ncicb.nci.nih.gov/xml/owl/EVS/Thesaurus.owl#Semantic_Type",
                            "namespace": "NCI_Thesaurus",/EVS/Thesaurus.owl#"
                     }
       "name": "Semantic_Type"
        }
            },
    },
        {
                "valuesubject": [{
                    "uri": "http://ncicb.nci.nih.gov/xml/owl/EVS/NCI_Thesaurus.owl#C27477",
         {
           "href": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurus/version/17.06d/entity/C27477",
                    "literalnamespace": {"NCI_Thesaurus",
                    "name": "C27477"
               "value": "Sign or Symptom" },
                "predicate": {
               }
     "uri": "http://ncicb.nci.nih.gov/xml/owl/EVS/NCI_Thesaurus.owl#R108",
                      }"name": "Disease_Has_Finding"
                        ]},
                "target": {
   },
                   "entity": {
                        "predicateuri": {
    "http://ncicb.nci.nih.gov/xml/owl/EVS/NCI_Thesaurus.owl#@75fee354830c997d4bc0e128e16aec09",
                        "urihref": "httphttps://ncicblexevscts2.nci.nih.gov/xml/owl/EVS/Thesaurus.owl#UMLS_CUI",
    /lexevscts2/codesystem/NCI_Thesaurus/version/17.06d/entity/@75fee354830c997d4bc0e128e16aec09",
                        "namespace": "NCI_Thesaurus",
                            "name": "UMLS_CUI@75fee354830c997d4bc0e128e16aec09"
                    }
     },
           },
                "valueassertedBy": [{
                    "version": {
            {
            "content": "NCI_Thesaurus-17.06d",
                        "literalhref": {"https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurus/version/17.06d"
                    },
                    "valuecodeSystem": "C0038999"{
                        "content": "NCI_Thesaurus",
       }
                 "uri": "http://ncicb.nci.nih.gov/xml/owl/EVS/Thesaurus.owl#"
          }
          }
              ]  }
            },
         },
   {
                "subject": {
                        "predicateuri": {"http://ncicb.nci.nih.gov/xml/owl/EVS/NCI_Thesaurus.owl#@75fee354830c997d4bc0e128e16aec09",
                            "uri"href": "httphttps://ncicblexevscts2.nci.nih.gov/lexevscts2/xmlcodesystem/owlNCI_Thesaurus/EVSversion/Thesaurus.owl#code17.06d/entity/@75fee354830c997d4bc0e128e16aec09",
                    "namespace": "NCI_Thesaurus",
                      "namespacename": "NCI_Thesaurus@75fee354830c997d4bc0e128e16aec09",
                },
                "namepredicate": "code"{
                        },
"uri": "http://ncicb.nci.nih.gov/xml/owl/EVS/NCI_Thesaurus.owl#R108",
                    "name": "Disease_Has_Finding"
    "value": [
           },
                "target": {
                    "entity": {
           "literal": {
            "uri": "http://ncicb.nci.nih.gov/xml/owl/EVS/NCI_Thesaurus.owl#C27374",
                        "valuehref": "C3399"https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurus/version/17.06d/entity/C27374",
                        "namespace": "NCI_Thesaurus",
       }
                 "name": "C27374"
          }
          }
              ]
  },
                  },"assertedBy": {
                    "version": {
                        "predicatecontent": {
  "NCI_Thesaurus-17.06d",
                          "urihref": "httphttps://ncicblexevscts2.nci.nih.gov/lexevscts2/xmlcodesystem/owlNCI_Thesaurus/EVSversion/Thesaurus17.owl#label06d",
                            "namespace": "NCI_Thesaurus",
       },
                     "namecodeSystem": "label"{
                        }"content": "NCI_Thesaurus",
                        "valueuri": ["http://ncicb.nci.nih.gov/xml/owl/EVS/Thesaurus.owl#"
                    }
        {
        }
             },
           "literal": {
                "subject": {
                    "valueuri": "Swelling"http://ncicb.nci.nih.gov/xml/owl/EVS/NCI_Thesaurus.owl#C27374",
                    "href": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurus/version/17.06d/entity/C27374",
           }
         "namespace": "NCI_Thesaurus",
                  }
  "name": "C27374"
                     ]},
                    }"predicate": {
                ],
                "subjectOf"uri": "httpshttp://lexevscts2ncicb.nci.nih.gov/xml/lexevscts2owl/codesystemEVS/NCI_Thesaurus/version/17.06d/entity/C3399/subjectof.owl#R108",
                    "targetOfname": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurus/version/17.06d/entity/C3399/targetof"Disease_Has_Finding"
                },
                "parenttarget": [{
                    "entity": {
                        "uri": "http://ncicb.nci.nih.gov/xml/owl/EVS/NCI_Thesaurus.owl#C53458owl#@75fee354830c997d4bc0e128e16aec09",
                        "href": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurus/version/17.06d/entity/C53458@75fee354830c997d4bc0e128e16aec09",
                        "namespace": "NCI_Thesaurus",
                        "name": "C53458@75fee354830c997d4bc0e128e16aec09"
                    }
                },
                "assertedBy": {
                    "version": {
                ]        "content": "NCI_Thesaurus-17.06d",
                "children        "href": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurus/version/17.06d/entity/C3399/children",
                   "entityType": [ },
                    "codeSystem": {
                        "uricontent": "http://www.w3.org/2002/07/owl#ClassNCI_Thesaurus",
                        "namespaceuri": "http://ncicb.nci.nih.gov/xml/owl/EVS/Thesaurus.owl#",
                    }
       "name": "Class"
        }
            }
        ],
        ]"complete": "PARTIAL",
        "numEntries": 5,
    }
        }"next": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurus/version/17.06d/entity/C3399/targetof?page=1&format=json&maxtoreturn=5",
        "heading": {
            "resourceRoot": "https://lexevscts2.nci.nih.gov/lexevscts2/",
            "resourceURI": "codesystem/NCI_Thesaurus/version/17.06d/entity/C3399/targetof",
            "parameter": [
                {
                    "arg": "formatmaxtoreturn",
                    "val": "json5"
                },
               ], {
            "accessDate": "2017-08-04T17:17:24.701-04:00"
        }
"arg": "format",
      }

}

Associations: Children

Returns all the children of the designated Entity

Code Block
http://<base url>/codesystem/NCI_Thesaurus/version/17.06d/entity/C3399/children?format=json

Output

Code Block
collapsetrue
{
    "EntityDirectory": {
        "entryval": ["json"
            {
    }
            "about": "http://ncicb.nci.nih.gov/xml/owl/EVS/NCI_Thesaurus.owl#C34569",
    ],
            "nameaccessDate": {"2017-08-04T17:21:47.508-04:00"
        }
    }

}

Map

Map Version Summaries

Returns a list of summaries of a all code system maps on page at a time (With the option of choosing page place and moving iteration to the next page).

Code Block
http://<base url>/mapversions?format=json

Output

Code Block
collapsetrue
{
    "MapVersionDirectory": {
        "namespace": "NCI_Thesaurus",
                    "name": "C34569"
                },
                "knownEntityDescription"entry": [
                    {
                        "hrefmapVersionName": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurus/version/17.06d/entity/C34569MA_to_NCIt_Mapping-1.0",
                        "describingCodeSystemVersion"versionOf": {
                            "versioncontent": {
           "MA_to_NCIt_Mapping",
                     "contenturi": "NCI_Thesaurus-17.06dMA_to_NCIt_Mapping",
                                "href": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurus/version/17.06d"
map/MA_to_NCIt_Mapping"
                },
               } "documentURI": "MA_to_NCIt_Mapping",
                "about": "MA_to_NCIt_Mapping",
                "codeSystemformalName": {"MA_to_NCIt_Mapping",
                "resourceSynopsis": {
                    "contentvalue": "NCI_Thesaurus","MA_to_NCIt_Mapping"
                },
                "urihref": "httphttps://ncicblexevscts2.nci.nih.gov/lexevscts2/xml/owl/EVS/Thesaurus.owl#map/MA_to_NCIt_Mapping/version/MA_to_NCIt_Mapping-1.0"
            },
                }{
                        },
        "mapVersionName": "GO_to_NCIt_Mapping-1.1",
                "designationversionOf": "Elephantiasis"{
                    }"content": "GO_to_NCIt_Mapping",
                ]
            },
   "uri": "GO_to_NCIt_Mapping",
         {
                "abouthref": "httphttps://ncicblexevscts2.nci.nih.gov/xmllexevscts2/owl/EVS/NCI_Thesaurus.owl#C3002",map/GO_to_NCIt_Mapping"
                "name": {},
                    "namespacedocumentURI": "NCI_ThesaurusGO_to_NCIt_Mapping",
                    "nameabout": "C3002"GO_to_NCIt_Mapping",
                }"formalName": "GO_to_NCIt_Mapping",
                "knownEntityDescriptionresourceSynopsis": [{
                    {
"value": "GO_to_NCIt_Mapping"
                },
                "href": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurusmap/GO_to_NCIt_Mapping/version/17.06d/entity/C3002",GO_to_NCIt_Mapping-1.1"
            },
            "describingCodeSystemVersion": {
                "mapVersionName": "NCIt_to_ChEBI_Mapping-1.0",
                "versionversionOf": {
                        "content": "NCIt_to_ChEBI_Mapping",
        "content": "NCI_Thesaurus-17.06d",
           "uri": "urn:oid:NCIt_to_ChEBI_Mapping",
                    "href": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurus/version/17.06dmap/NCIt_to_ChEBI_Mapping"
                },
            }    "documentURI": "urn:oid:NCIt_to_ChEBI_Mapping",
                "about": "urn:oid:NCIt_to_ChEBI_Mapping",
                "codeSystemformalName": {"NCIt_to_ChEBI_Mapping",
                "resourceSynopsis": {
                    "contentvalue": "NCI_Thesaurus",NCIt_to_ChEBI_Mapping"
                },
                "urihref": "httphttps://ncicblexevscts2.nci.nih.gov/xml/owl/EVS/Thesaurus.owl#"
                            }
            lexevscts2/map/NCIt_to_ChEBI_Mapping/version/NCIt_to_ChEBI_Mapping-1.0"
            },
            {
                "designationmapVersionName": "Edema"PDQ_2016_07_31_TO_NCI_2016_10E-2016_07_31",
                    }"versionOf": {
                ]
      "content": "PDQ_2016_07_31_TO_NCI_2016_10E",
      }
        ],
        "completeuri": "COMPLETEurn:oid:CL512803.PDQ.NCI",
        "numEntries": 2,
        "heading": {
            "resourceRoot"href": "https://lexevscts2.nci.nih.gov/lexevscts2/map/",
PDQ_2016_07_31_TO_NCI_2016_10E"
               "resourceURI": "codesystem/NCI_Thesaurus/version/17.06d/entity/C3399/children" },
                "parameterdocumentURI": ["urn:oid:CL512803.PDQ.NCI",
                {
    "about": "urn:oid:CL512803.PDQ.NCI",
                "argformalName": "formatPDQ_2016_07_31_TO_NCI_2016_10E",
                    "val": "json""href": "https://lexevscts2.nci.nih.gov/lexevscts2/map/PDQ_2016_07_31_TO_NCI_2016_10E/version/PDQ_2016_07_31_TO_NCI_2016_10E-2016_07_31"
            },
    }
        {
    ],
            "accessDatemapVersionName": "2017-08-04T17:18:44.257-04:00"
 SNOMEDCT_US_2016_09_01_TO_ICD10_2010-20160901",
       }
    }

}

Associations: SubjectOf

Returns all entities that are the subject of an association with this entity.

Code Block
http://<base url>/codesystem/NCI_Thesaurus/version/17.06d/entity/C3399/subjectof?format=json

Output

Code Block
collapsetrue
{

    "AssociationDirectoryversionOf": {
        "entry": [
            {
                "subject"content": {"SNOMEDCT_US_2016_09_01_TO_ICD10_2010",
                    "uri": "http://ncicb.nci.nih.gov/xml/owl/EVS/NCI_Thesaurus.owl#C3399urn:oid:C3645687.SNOMEDCT_US.ICD10",
                    "href": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurus/version/17.06d/entity/C3399",
                    "namespace": "NCI_Thesaurus",
  map/SNOMEDCT_US_2016_09_01_TO_ICD10_2010"
                },
  "name": "C3399"
                }"documentURI": "urn:oid:C3645687.SNOMEDCT_US.ICD10",
                "predicateabout": {
  "urn:oid:C3645687.SNOMEDCT_US.ICD10",
                  "uriformalName": "http://ncicb.nci.nih.gov/xml/owl/EVS/NCI_Thesaurus.owl#A8",
  SNOMEDCT_US_2016_09_01_TO_ICD10_2010",
                  "namehref": "Concept_In_Subset"
    https://lexevscts2.nci.nih.gov/lexevscts2/map/SNOMEDCT_US_2016_09_01_TO_ICD10_2010/version/SNOMEDCT_US_2016_09_01_TO_ICD10_2010-20160901"
            },
                "target": {
                    "entitymapVersionName": {
        "SNOMEDCT_US_2016_09_01_TO_ICD10CM_2014-20160901",
                "uriversionOf": "http://ncicb.nci.nih.gov/xml/owl/EVS/NCI_Thesaurus.owl#C62596",
    {
                    "hrefcontent": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurus/version/17.06d/entity/C62596",
  SNOMEDCT_US_2016_09_01_TO_ICD10CM_2014",
                      "namespaceuri": "NCI_Thesaurusurn:oid:C3645705.SNOMEDCT_US.ICD10CM",
                        "namehref": "C62596"
    https://lexevscts2.nci.nih.gov/lexevscts2/map/SNOMEDCT_US_2016_09_01_TO_ICD10CM_2014"
                },
                }"documentURI": "urn:oid:C3645705.SNOMEDCT_US.ICD10CM",
                "assertedByabout": {"urn:oid:C3645705.SNOMEDCT_US.ICD10CM",
                    "versionformalName": {"SNOMEDCT_US_2016_09_01_TO_ICD10CM_2014",
                "href": "https://lexevscts2.nci.nih.gov/lexevscts2/map/SNOMEDCT_US_2016_09_01_TO_ICD10CM_2014/version/SNOMEDCT_US_2016_09_01_TO_ICD10CM_2014-20160901"
           "content": "NCI_Thesaurus-17.06d" },
            {
                "hrefmapVersionName": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurus/version/17.06d"NCIt_to_HGNC_Mapping-1.0",
                "versionOf": {
   },
                   "content": "codeSystem": {NCIt_to_HGNC_Mapping",
                        "contenturi": "NCI_ThesaurusNCIt_to_HGNC_Mapping",
                        "urihref": "httphttps://ncicblexevscts2.nci.nih.gov/xmllexevscts2/owl/EVS/Thesaurus.owl#"
map/NCIt_to_HGNC_Mapping"
                },
      }
          "documentURI": "NCIt_to_HGNC_Mapping",
     }
            }"about": "NCIt_to_HGNC_Mapping",
              {  "formalName": "NCIt_to_HGNC_Mapping",
                "subjectresourceSynopsis": {
                    "urivalue": "http://ncicb.nci.nih.gov/xml/owl/EVS/NCI_Thesaurus.owl#C62596",NCIt_to_HGNC_Mapping"
                },
                "href": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurusmap/NCIt_to_HGNC_Mapping/version/17.06d/entity/C62596",
NCIt_to_HGNC_Mapping-1.0"
            }
        ],
  "namespace      "complete": "NCI_Thesaurus""COMPLETE",
        "numEntries": 7,
        "heading": {
            "nameresourceRoot": "C62596"https://lexevscts2.nci.nih.gov/lexevscts2/",
            "resourceURI": "mapversions",
      },
        "parameter": [
              "predicate":  {
                    "uriarg": "http://ncicb.nci.nih.gov/xml/owl/EVS/NCI_Thesaurus.owl#A8format",
                    "nameval": "Concept_In_Subsetjson"
                },
                "target": {
 ],
                   "entity"accessDate": {"2017-08-04T17:23:10.907-04:00"
        }
                "uri": "http://ncicb.nci.nih.gov/xml/owl/EVS/NCI_Thesaurus.owl#C54450",}

}

Map Version Read

Returns a specific map version for a given map version resource synopsis.

Code Block
http://<base url>/map/MA_to_NCIt_Mapping/version/MA_to_NCIt_Mapping-1.0?format=json

Output

Code Block
collapsetrue
{
    "MapVersionMsg": {
        "mapVersion": {
            "hrefmapVersionName": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurus/version/17.06d/entity/C54450",
MA_to_NCIt_Mapping-1.0",
            "versionOf": {
                "namespacecontent": "NCI_ThesaurusMA_to_NCIt_Mapping",
                        "nameuri": "C54450"
   MA_to_NCIt_Mapping",
                 }
   "href": "https://lexevscts2.nci.nih.gov/lexevscts2/map/MA_to_NCIt_Mapping"
             },
                "assertedByfromCodeSystemVersion": {
                    "version": {
                        "content": "NCI_Thesaurus-17.06dma-null",
                        "href": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurusma/version/17.06dnull"
                    },
                    "codeSystem": {
                        "content": "NCI_Thesaurus",ma"
                }
            },
            "uritoCodeSystemVersion": "http://ncicb.nci.nih.gov/xml/owl/EVS/Thesaurus.owl#"{
                "version": {
   }
                 }"content": "NCI_Thesaurus-null",
            },
        "href": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurus/version/null"
                {},
                "subjectcodeSystem": {
                    "uricontent": "http://ncicb.nci.nih.gov/xml/owl/EVS/NCI_Thesaurus.owl#C54450",
                    "href": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurus/version/17.06d/entity/C54450",   }
            },
            "namespacedocumentURI": "NCI_ThesaurusMA_to_NCIt_Mapping",
            "state": "FINAL",
            "namesourceAndNotation": "C54450"{
                },"sourceAndNotationDescription": "LexEVS"
            },
    "predicate": {
       "about": "MA_to_NCIt_Mapping",
            "uriformalName": "http://www.w3.org/2000/01/rdf-schema#subClassOfMA_to_NCIt_Mapping",
            "keyword": [
       "name": "subClassOf"
        "MA_to_NCIt_Mapping"
        },
    ],
            "targetresourceSynopsis": {
                    "entityvalue": {"MA_to_NCIt_Mapping"
            },
            "urientryState": "http://ncicb.nci.nih.gov/xml/owl/EVS/NCI_Thesaurus.owl#C53458",ACTIVE"
        },
        "heading": {
            "hrefresourceRoot": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurus/version/17.06d/entity/C53458",
                        "namespace"resourceURI": "NCI_Thesaurusmap/MA_to_NCIt_Mapping/version/MA_to_NCIt_Mapping-1.0",
                        "name"parameter": "C53458"[
                {
    }
                }"arg": "format",
                    "assertedByval": {"json"
                    "version": {}
            ],
            "contentaccessDate": "NCI_Thesaurus-17.06d",2017-08-04T17:25:58.902-04:00"
        }
    }

}

Map Entries

Paginated entries of this Map Version

Code Block
http://<base url>/map/MA_to_NCIt_Mapping/version/MA_to_NCIt_Mapping-1.0/entries?maxtoreturn=3&format=json

Output

Code Block
collapsetrue
{
    "MapEntryDirectory": {
        "hrefentry": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurus/version/17.06d"[
            {
        },        "assertedBy": {
                    "codeSystemmapVersion": {
                        "content": "NCI_ThesaurusMA_to_NCIt_Mapping-1.0",
                        "urihref": "httphttps://ncicblexevscts2.nci.nih.gov/xml/owl/EVS/Thesaurus.owl#lexevscts2/codesystem/MA_to_NCIt_Mapping/version/1.0"
                    },
                 }
   "map": {
        }
        ],
        "completecontent": "COMPLETEMA_to_NCIt_Mapping",
        "numEntries": 3,
        "heading": {
            "resourceRoothref": "https://lexevscts2.nci.nih.gov/lexevscts2/",map/MA_to_NCIt_Mapping"
                    }
            "resourceURI": "codesystem/NCI_Thesaurus/version/17.06d/entity/C3399/subjectof",
    },
                "parametermapFrom": [{
                {    "uri": "http://www.w3.org/ns/ma-ont#MA:0000002",
                    "argnamespace": "formatMA",
                    "valname": "jsonMA:0000002"
                },
            ],
    "href": "https://lexevscts2.nci.nih.gov/lexevscts2/map/MA_to_NCIt_Mapping/version/MA_to_NCIt_Mapping-1.0/entry/MA:MA%253A0000002",
                "accessDateresourceName": "2017-08-04T17:19:36.589-04:00"
MA:MA%253A0000002"
            },
      }

}

Associations: TargetOf

Returns all entities that are the target of this entity in an association

Code Block
http://<base url>/codesystem/NCI_Thesaurus/version/17.06d/entity/C3399/targetof?maxtoreturn=5&format=json

Output

Code Block
collapsetrue
{

    "AssociationDirectory": {
        "entry": [
       "assertedBy": {
    {
                "subjectmapVersion": {
                        "uricontent": "http://ncicb.nci.nih.gov/xml/owl/EVS/NCI_Thesaurus.owl#C3399",
MA_to_NCIt_Mapping-1.0",
                        "href": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_ThesaurusMA_to_NCIt_Mapping/version/17.06d/entity/C3399",1.0"
                    "namespace": "NCI_Thesaurus"},
                    "namemap": "C3399"{
                },
        "content": "MA_to_NCIt_Mapping",
       "predicate": {
                    "urihref": "httphttps://ncicblexevscts2.nci.nih.gov/xmllexevscts2/owl/EVS/NCI_Thesaurus.owl#R108",map/MA_to_NCIt_Mapping"
                    "name": "Disease_Has_Finding"}
                },
                "targetmapFrom": {
                    "entityuri": {"http://www.w3.org/ns/ma-ont#MA:0000003",
                    "namespace": "MA",
                    "uriname": "http://ncicb.nci.nih.gov/xml/owl/EVS/NCI_Thesaurus.owl#@75fee354830c997d4bc0e128e16aec09",
MA:0000003"
                },
                "href": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurusmap/MA_to_NCIt_Mapping/version/17.06d/entity/@75fee354830c997d4bc0e128e16aec09MA_to_NCIt_Mapping-1.0/entry/MA:MA%253A0000003",
                        "namespace"resourceName": "NCI_Thesaurus",
                        "name": "@75fee354830c997d4bc0e128e16aec09"
        MA:MA%253A0000003"
            },
                },{
                "assertedBy": {
                    "versionmapVersion": {
                        "content": "NCI_Thesaurus-17.06dMA_to_NCIt_Mapping-1.0",
                        "href": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_ThesaurusMA_to_NCIt_Mapping/version/171.06d0"
                    },
                    "codeSystemmap": {
                        "content": "NCI_ThesaurusMA_to_NCIt_Mapping",
                        "urihref": "httphttps://ncicblexevscts2.nci.nih.gov/xmllexevscts2/owl/EVS/Thesaurus.owl#map/MA_to_NCIt_Mapping"
                    }
                }
            },
            {
                "subjectmapFrom": {
                    "uri": "http://ncicbwww.nciw3.nih.govorg/xml/owl/EVS/NCI_Thesaurus.owl#@75fee354830c997d4bc0e128e16aec09",
                    "href": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurus/version/17.06d/entity/@75fee354830c997d4bc0e128e16aec09ns/ma-ont#MA:0000004",
                    "namespace": "NCI_Thesaurus",
                    "name": "@75fee354830c997d4bc0e128e16aec09MA",
                },
    "name": "MA:0000004"
           "predicate": {
    },
                "urihref": "httphttps://ncicblexevscts2.nci.nih.gov/lexevscts2/xml/owl/EVS/NCI_Thesaurus.owl#R108",
    map/MA_to_NCIt_Mapping/version/MA_to_NCIt_Mapping-1.0/entry/MA:MA%253A0000004",
                "nameresourceName": "Disease_Has_FindingMA:MA%253A0000004"
                },
        ],
        "targetcomplete": {"PARTIAL",
                    "entity"numEntries": {3,
                        "uri"next": "httphttps://ncicblexevscts2.nci.nih.gov/lexevscts2/xml/owl/EVS/NCI_Thesaurus.owl#C27477map/MA_to_NCIt_Mapping/version/MA_to_NCIt_Mapping-1.0/entries?page=1&format=json&maxtoreturn=3",
            "heading": {
            "hrefresourceRoot": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurus/version/17.06d/entity/C27477",
                        "namespace"resourceURI": "NCI_Thesaurus",
                        "name": "C27477"map/MA_to_NCIt_Mapping/version/MA_to_NCIt_Mapping-1.0/entries",
              "parameter": [
      }
          {
      },
                "assertedByarg": {"maxtoreturn",
                    "versionval": {"3"
                },
        "content": "NCI_Thesaurus-17.06d",
        {
                    "hrefarg": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurus/version/17.06d"format",
                    },"val": "json"
                    "codeSystem": {}
            ],
            "contentaccessDate": "NCI_Thesaurus",2017-08-04T17:28:42.923-04:00"
        }
                "uri": "http://ncicb.nci.nih.gov/xml/owl/EVS/Thesaurus.owl#"}

}

Map Entry

Restrict to/from entity code system

Code Block
http://<base url>/map/MA_to_NCIt_Mapping/version/MA_to_NCIt_Mapping-1.0/entry/MA:MA%253A0000002?format=json

Output

Code Block
collapsetrue
{
    "MapEntryMsg": {
               }"entry": {
                }
            }"processingRule": "ALL_MATCHES",
            "assertedBy": {
                "subjectmapVersion": {
                    "uricontent": "http://ncicb.nci.nih.gov/xml/owl/EVS/NCI_Thesaurus.owl#C27477MA_to_NCIt_Mapping-1.0",
                    "href": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_ThesaurusMA_to_NCIt_Mapping/version/17.06d/entity/C27477",1.0"
                    "namespace": "NCI_Thesaurus"},
                    "namemap": "C27477"{
                },
                "predicate"content": {"MA_to_NCIt_Mapping",
                    "urihref": "httphttps://ncicblexevscts2.nci.nih.gov/xmllexevscts2/owl/EVS/NCI_Thesaurus.owl#R108",map/MA_to_NCIt_Mapping"
                }
    "name": "Disease_Has_Finding"
        },
             },"mapFrom": {
                "targeturi": {
    "http://www.w3.org/ns/ma-ont#MA:0000002",
                "entitynamespace": {
   "MA",
                     "uriname": "http://ncicb.nci.nih.gov/xml/owl/EVS/NCI_Thesaurus.owl#@75fee354830c997d4bc0e128e16aec09",MA:0000002"
            },
            "href": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurus/version/17.06d/entity/@75fee354830c997d4bc0e128e16aec09",
"mapSet": [
                {
                    "namespaceprocessingRule": "NCIALL_ThesaurusMATCHES",
                        "nameentryOrder": "@75fee354830c997d4bc0e128e16aec09"1,
                    }"mapTarget": [
                },
         {
       "assertedBy": {
                    "versionentryOrder": {
1,
                            "contentmapTo": "NCI_Thesaurus-17.06d",
{
                                "hrefuri": "httpshttp://lexevscts2ncicb.nci.nih.gov/xml/lexevscts2owl/codesystemEVS/NCI_Thesaurus/version/17.06dowl#C32696",
                    },
            "namespace": "NCI_Thesaurus",
       "codeSystem": {
                        "contentname": "NCI_ThesaurusC32696",
                        "uri": "http://ncicb.nci.nih.gov/xml/owl/EVS/Thesaurus.owl#"
    }
                        }
                }    ]
                },
            {],
            "entryState": "ACTIVE"
       "subject": { },
        "heading": {
            "uriresourceRoot": "httphttps://ncicblexevscts2.nci.nih.gov/xml/owl/EVS/NCI_Thesaurus.owl#@75fee354830c997d4bc0e128e16aec09/lexevscts2/",
            "resourceURI": "map/MA_to_NCIt_Mapping/version/MA_to_NCIt_Mapping-1.0/entry/MA:MA%3A0000002",
            "parameter": [
               "href": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurus/version/17.06d/entity/@75fee354830c997d4bc0e128e16aec09", {
                    "namespacearg": "NCI_Thesaurusformat",
                    "nameval": "@75fee354830c997d4bc0e128e16aec09json"
                },
            ],
    "predicate": {
       "accessDate": "2017-08-07T11:08:54.296-04:00"
        }
    "uri": "http://ncicb.nci.nih.gov/xml/owl/EVS/NCI_Thesaurus.owl#R108",}

}

Map Version Query

Returns a range of Maps for a text match on the resourceSynopsis.

Code Block
http://<base url>/mapversions?matchvalue=ncit&filtercomponent=resourceSynopsis&format=json

Output

Code Block
languagehtml/xml
collapsetrue
{
    "MapVersionDirectory": {
        "entry": [
           "name": "Disease_Has_Finding" {
                }"mapVersionName": "MA_to_NCIt_Mapping-1.0",
                "targetversionOf": {
                    "entitycontent": {
 "MA_to_NCIt_Mapping",
                       "uri": "http://ncicb.nci.nih.gov/xml/owl/EVS/NCI_Thesaurus.owl#C27374MA_to_NCIt_Mapping",
                        "href": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurus/version/17.06d/entity/C27374",map/MA_to_NCIt_Mapping"
                        "namespace": "NCI_Thesaurus"},
                        "name"documentURI": "C27374"MA_to_NCIt_Mapping",
                "about": "MA_to_NCIt_Mapping",
   }
                }"formalName": "MA_to_NCIt_Mapping",
                "assertedByresourceSynopsis": {
                    "versionvalue": {"MA_to_NCIt_Mapping"
                        "content": "NCI_Thesaurus-17.06d"},
                        "href": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurusmap/MA_to_NCIt_Mapping/version/17.06dMA_to_NCIt_Mapping-1.0"
            },
        },
    {
                "codeSystemmapVersionName": {
"GO_to_NCIt_Mapping-1.1",
                "versionOf": {
                    "content": "NCI_ThesaurusGO_to_NCIt_Mapping",
                    "uri": "GO_to_NCIt_Mapping",
                    "urihref": "httphttps://ncicblexevscts2.nci.nih.gov/xmllexevscts2/owl/EVS/Thesaurus.owl#map/GO_to_NCIt_Mapping"
                },
     }
           "documentURI": "GO_to_NCIt_Mapping",
    }
            }"about": "GO_to_NCIt_Mapping",
                {"formalName": "GO_to_NCIt_Mapping",
                "subjectresourceSynopsis": {
                    "urivalue": "http://ncicb.nci.nih.gov/xml/owl/EVS/NCI_Thesaurus.owl#C27374",GO_to_NCIt_Mapping"
                },
                "href": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurusmap/GO_to_NCIt_Mapping/version/17.06d/entity/C27374"GO_to_NCIt_Mapping-1.1"
            },
            {
        "namespace        "mapVersionName": "NCI_ThesaurusNCIt_to_ChEBI_Mapping-1.0",
                "versionOf": {
    "name": "C27374"
                }"content": "NCIt_to_ChEBI_Mapping",
                    "predicateuri": {"urn:oid:NCIt_to_ChEBI_Mapping",
                    "urihref": "httphttps://ncicblexevscts2.nci.nih.gov/xmllexevscts2/owl/EVS/NCI_Thesaurus.owl#R108",map/NCIt_to_ChEBI_Mapping"
                 },
                "namedocumentURI": "Disease_Has_Finding"
urn:oid:NCIt_to_ChEBI_Mapping",
                 }"about": "urn:oid:NCIt_to_ChEBI_Mapping",
                "targetformalName": {
  "NCIt_to_ChEBI_Mapping",
                  "entityresourceSynopsis": {
                        "urivalue": "http://ncicb.nci.nih.gov/xml/owl/EVS/NCI_Thesaurus.owl#@75fee354830c997d4bc0e128e16aec09",NCIt_to_ChEBI_Mapping"
                },
                "href": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurusmap/NCIt_to_ChEBI_Mapping/version/17.06d/entity/@75fee354830c997d4bc0e128e16aec09",NCIt_to_ChEBI_Mapping-1.0"
            },
            "namespace": "NCI_Thesaurus",{
                        "name"mapVersionName": "@75fee354830c997d4bc0e128e16aec09"NCIt_to_HGNC_Mapping-1.0",
                "versionOf": {
   }
                 }"content": "NCIt_to_HGNC_Mapping",
                    "assertedByuri": {"NCIt_to_HGNC_Mapping",
                    "versionhref": {"https://lexevscts2.nci.nih.gov/lexevscts2/map/NCIt_to_HGNC_Mapping"
                },
        "content        "documentURI": "NCI_Thesaurus-17.06d",
       NCIt_to_HGNC_Mapping",
                 "hrefabout": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurus/version/17.06d"NCIt_to_HGNC_Mapping",
                    },
    "formalName": "NCIt_to_HGNC_Mapping",
                "codeSystemresourceSynopsis": {
                        "contentvalue": "NCI_Thesaurus",
NCIt_to_HGNC_Mapping"
                },
                "urihref": "httphttps://ncicblexevscts2.nci.nih.gov/lexevscts2/xml/owl/EVS/Thesaurus.owl#map/NCIt_to_HGNC_Mapping/version/NCIt_to_HGNC_Mapping-1.0"
            }
        }],
        "complete": "COMPLETE",
        }"numEntries": 4,
        "heading": {
     }
        ]"resourceRoot": "https://lexevscts2.nci.nih.gov/lexevscts2/",
            "completeresourceURI": "PARTIALmapversions",
            "numEntriesparameter": 5,
[
               "next": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurus/version/17.06d/entity/C3399/targetof?page=1&format=json&maxtoreturn=5", {
        "heading": {
            "resourceRootarg": "https://lexevscts2.nci.nih.gov/lexevscts2/"matchvalue",
            "resourceURI        "val": "codesystem/NCI_Thesaurus/version/17.06d/entity/C3399/targetof",ncit"
            "parameter": [    },
                {
                    "arg": "maxtoreturnfiltercomponent",
                    "val": "5resourceSynopsis"
                },
                {
                    "arg": "format",
                    "val": "json"
                }
            ],
            "accessDate": "2017-08-04T1707T11:2110:4740.508849-04:00"
        }
    }

}

Map Versions

Map Version Summaries

Returns a list of summaries of a all code system maps on page at a time (With the option of choosing page place and moving iteration to the next page)Of a single code system

Code Block
http://<base url>/mapversions/map/GO_to_NCIt_Mapping/versions?format=json

Output

Code Block
collapsetrue
{

    "MapVersionDirectory": {
        "entry": [
            {
                "mapVersionName": "MAGO_to_NCIt_Mapping-1.01",
                "versionOf": {
                    "content": "MAGO_to_NCIt_Mapping",
                    "uri": "MAGO_to_NCIt_Mapping",
                    "href": "https://lexevscts2.nci.nih.gov/lexevscts2/map/MAGO_to_NCIt_Mapping"
                },
                "documentURI": "MAGO_to_NCIt_Mapping",
                "about": "MAGO_to_NCIt_Mapping",
                "formalName": "MAGO_to_NCIt_Mapping",
                "resourceSynopsis": {
                    "value": "MAGO_to_NCIt_Mapping"
                },
                "href": "https://lexevscts2.nci.nih.gov/lexevscts2/map/MAGO_to_NCIt_Mapping/version/MAGO_to_NCIt_Mapping-1.01"
            },
            {],
                "mapVersionName"complete": "GO_to_NCIt_Mapping-1.1COMPLETE",
                "versionOf": {
                    "content": "GO_to_NCIt_Mapping""numEntries": 1,
                    "uri"heading": "GO_to_NCIt_Mapping",
     {
               "hrefresourceRoot": "https://lexevscts2.nci.nih.gov/lexevscts2/map/GO_to_NCIt_Mapping"
                },
  /lexevscts2/",
              "documentURIresourceURI": "map/GO_to_NCIt_Mapping/versions",
                "aboutparameter": "GO_to_NCIt_Mapping",[
                "formalName": "GO_to_NCIt_Mapping",
{
                    "resourceSynopsisarg": {"format",
                    "valueval": "GO_to_NCIt_Mappingjson"
                },
            ],
     "href       "accessDate": "https://lexevscts2.nci.nih.gov/lexevscts2/map/GO_to_NCIt_Mapping/version/GO_to_NCIt_Mapping-1.1"2017-08-07T11:14:16.315-04:00"
        }
    }

}

Map Restriction to Role

To/From mapping example (Also MAP_FROM_ROLE)

Code Block
http://<base url>/mapversions?codesystem=ICD10&codesystemsmaprole=MAP_TO_ROLE&format=json

Output

Code Block
collapsetrue
{
    "MapVersionDirectory": {
       }, "entry": [
            {
                "mapVersionName": "NCIt_to_ChEBI_Mapping-1.0SNOMEDCT_US_2016_09_01_TO_ICD10_2010-20160901",
                "versionOf": {
                    "content": "NCIt_to_ChEBI_MappingSNOMEDCT_US_2016_09_01_TO_ICD10_2010",
                    "uri": "urn:oid:NCIt_to_ChEBI_MappingC3645687.SNOMEDCT_US.ICD10",
                    "href": "https://lexevscts2.nci.nih.gov/lexevscts2/map/NCIt_to_ChEBI_MappingSNOMEDCT_US_2016_09_01_TO_ICD10_2010"
                },
                "documentURI": "urn:oid:NCIt_to_ChEBI_MappingC3645687.SNOMEDCT_US.ICD10",
                "about": "urn:oid:NCIt_to_ChEBI_MappingC3645687.SNOMEDCT_US.ICD10",
                "formalName": "NCIt_to_ChEBI_MappingSNOMEDCT_US_2016_09_01_TO_ICD10_2010",
                "resourceSynopsishref": {"https://lexevscts2.nci.nih.gov/lexevscts2/map/SNOMEDCT_US_2016_09_01_TO_ICD10_2010/version/SNOMEDCT_US_2016_09_01_TO_ICD10_2010-20160901"
            }
        "value],
        "complete": "NCIt_to_ChEBI_Mapping"COMPLETE",
        "numEntries": 1,
       },
     "heading": {
            "hrefresourceRoot": "https://lexevscts2.nci.nih.gov/lexevscts2/map/NCIt_to_ChEBI_Mapping/version/NCIt_to_ChEBI_Mapping-1.0"",
            }"resourceURI": "mapversions",
            "parameter": [
                {
                    "mapVersionNamearg": "PDQ_2016_07_31_TO_NCI_2016_10E-2016_07_31codesystem",
                    "versionOfval": {"ICD10"
                },
         "content": "PDQ_2016_07_31_TO_NCI_2016_10E",       {
                    "uriarg": "urn:oid:CL512803.PDQ.NCIcodesystemsmaprole",
                    "hrefval": "https://lexevscts2.nci.nih.gov/lexevscts2/map/PDQ_2016_07_31MAP_TO_NCI_2016_10EROLE"
                },
                {
                    "documentURIarg": "urn:oid:CL512803.PDQ.NCIformat",
                    "aboutval": "urn:oid:CL512803.PDQ.NCI",
json"
                 "formalName": "PDQ_2016_07_31_TO_NCI_2016_10E",
}
            ],
            "hrefaccessDate": "2017-08-07T11:23:41.341-04:00"
        }
    }

}

Map To/From or Both

Map to or from an entity or use MAP_FROM_BOTH.

Code Block
http://<base url>/mapversions?entity=22298006&entitiesmaprole=MAP_FROM_ROLE&format=json

Output

Code Block
collapsetrue
{
    "MapVersionDirectory": {
https://lexevscts2.nci.nih.gov/lexevscts2/map/PDQ_2016_07_31_TO_NCI_2016_10E/version/PDQ_2016_07_31_TO_NCI_2016_10E-2016_07_31"
            },"entry": [
            {
                "mapVersionName": "SNOMEDCT_US_2016_09_01_TO_ICD10_2010-20160901",
                "versionOf": {
                    "content": "SNOMEDCT_US_2016_09_01_TO_ICD10_2010",
                    "uri": "urn:oid:C3645687.SNOMEDCT_US.ICD10",
                    "href": "https://lexevscts2.nci.nih.gov/lexevscts2/map/SNOMEDCT_US_2016_09_01_TO_ICD10_2010"
                },
                "documentURI": "urn:oid:C3645687.SNOMEDCT_US.ICD10",
                "about": "urn:oid:C3645687.SNOMEDCT_US.ICD10",
                "formalName": "SNOMEDCT_US_2016_09_01_TO_ICD10_2010",
                "href": "https://lexevscts2.nci.nih.gov/lexevscts2/map/SNOMEDCT_US_2016_09_01_TO_ICD10_2010/version/SNOMEDCT_US_2016_09_01_TO_ICD10_2010-20160901"
            },
            {
                "mapVersionName": "SNOMEDCT_US_2016_09_01_TO_ICD10CM_2014-20160901",
                "versionOf": {
                    "content": "SNOMEDCT_US_2016_09_01_TO_ICD10CM_2014",
                    "uri": "urn:oid:C3645705.SNOMEDCT_US.ICD10CM",
                    "href": "https://lexevscts2.nci.nih.gov/lexevscts2/map/SNOMEDCT_US_2016_09_01_TO_ICD10CM_2014"
                },
                "documentURI": "urn:oid:C3645705.SNOMEDCT_US.ICD10CM",
                "about": "urn:oid:C3645705.SNOMEDCT_US.ICD10CM",
                "formalName": "SNOMEDCT_US_2016_09_01_TO_ICD10CM_2014",
                "href": "https://lexevscts2.nci.nih.gov/lexevscts2/map/SNOMEDCT_US_2016_09_01_TO_ICD10CM_2014/version/SNOMEDCT_US_2016_09_01_TO_ICD10CM_2014-20160901"
            },
            {],
                "mapVersionName"complete": "NCIt_to_HGNC_Mapping-1.0COMPLETE",
                "versionOfnumEntries": {
                    "content": "NCIt_to_HGNC_Mapping"2,
                    "uri"heading": "NCIt_to_HGNC_Mapping",
      {
              "hrefresourceRoot": "https://lexevscts2.nci.nih.gov/lexevscts2/map/NCIt_to_HGNC_Mapping"
                },
                "documentURIresourceURI": "NCIt_to_HGNC_Mappingmapversions",
                "aboutparameter": "NCIt_to_HGNC_Mapping",
 [
               "formalName": "NCIt_to_HGNC_Mapping",
                "resourceSynopsis": {
                    "value": "NCIt_to_HGNC_Mapping" {
                }    "arg": "entity",
                    "hrefval": "https://lexevscts2.nci.nih.gov/lexevscts2/map/NCIt_to_HGNC_Mapping/version/NCIt_to_HGNC_Mapping-1.0"
 22298006"
           }
        ]},
        "complete": "COMPLETE",
        "numEntries": 7,{
        "heading": {
            "resourceRootarg": "https://lexevscts2.nci.nih.gov/lexevscts2/entitiesmaprole",
            "resourceURI        "val": "mapversionsMAP_FROM_ROLE",
               "parameter": [ },
                {
                    "arg": "format",
                    "val": "json"
                }
            ],
            "accessDate": "2017-08-04T1707T11:2329:1007.907216-04:00"
        }
    }

}

Map Version Read

ResolvedValueSet Summaries

Returns all resolved value set entries with the option to page. (Place number or iteration are both possible on pagination.)Returns a specific map version for a given map version resource synopsis

Code Block
http://<base url>/map/MA_to_NCIt_Mapping/version/MA_to_NCIt_Mapping-1.0?resolvedvaluesets?maxtoreturn=3&format=json

Output

Code Block
collapsetrue
{

    "MapVersionMsgResolvedValueSetDirectory": {
        "mapVersionentry": [
            {
                "mapVersionNamehref": "MA_to_NCIt_Mapping-1.0https://lexevscts2.nci.nih.gov/lexevscts2/valueset/CDISC Questionnaire Terminology/definition/aa5e7b3f/resolution/1",
                "versionOfresolvedValueSetURI": {"http://evs.nci.nih.gov/valueset/C100110",
                "contentresolvedHeader": "MA_to_NCIt_Mapping",
{
                    "uriresolutionOf": "MA_to_NCIt_Mapping",
{
                        "hrefvalueSetDefinition": "https://lexevscts2.nci.nih.gov/lexevscts2/map/MA_to_NCIt_Mapping"
{
              },
              "fromCodeSystemVersioncontent": {"aa5e7b3f",
                "version": {
           "uri": "http://evs.nci.nih.gov/valueset/C100110",
        "content": "ma-null",
                    "href": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/ma/version/null"
valueset/CDISC Questionnaire Terminology/definition/aa5e7b3f"
                        },
                "codeSystem        "valueSet": {
                    "content": "ma"
       "content": "CDISC Questionnaire Terminology"
      }
            },
      }
      "toCodeSystemVersion": {
                "version": {},
                    "contentresolvedUsingCodeSystem": "NCI_Thesaurus-null",[
                    "href": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurus/version/null"
    {
            },
                "codeSystemversion": {
                                "content": "NCI_Thesaurus-17.06d"
                }
            },
            "documentURI": "MA_to_NCIt_Mapping",
                "statecodeSystem": "FINAL",{
            "sourceAndNotation": {
                    "sourceAndNotationDescriptioncontent": "LexEVSNCI_Thesaurus",
            },
            "about": "MA_to_NCIt_Mapping",
            "formalNameuri": "MA_to_NCIt_Mapping",
 http://ncicb.nci.nih.gov/xml/owl/EVS/Thesaurus.owl#"
           "keyword": [
                "MA_to_NCIt_Mapping"}
            ],
            "resourceSynopsis": {}
                "value": "MA_to_NCIt_Mapping"
   ]
         },
       }
     "entryState": "ACTIVE"
        },
           "heading": {
                "resourceRoothref": "https://lexevscts2.nci.nih.gov/lexevscts2/valueset/CDISC Questionnaire Category Terminology/definition/f8af9058/resolution/1",
                "resourceURIresolvedValueSetURI": "map/MA_to_NCIt_Mapping/version/MA_to_NCIt_Mapping-1.0",
http://evs.nci.nih.gov/valueset/C100129",
                "parameterresolvedHeader": [{
                    "resolutionOf": {
                        "argvalueSetDefinition": "format",{
                    "val": "json"
       "content": "f8af9058",
        }
            ],
            "accessDateuri": "2017-08-04T17:25:58.902-04:00"
http://evs.nci.nih.gov/valueset/C100129",
          }
    }

}

Map Entries

Paginated entries of this Map Version

Code Block
http://<base url>/map/MA_to_NCIt_Mapping/version/MA_to_NCIt_Mapping-1.0/entries?maxtoreturn=3&format=json

Output

Code Block
collapsetrue
{

    "MapEntryDirectory": {
        "href"entry: "https: [//lexevscts2.nci.nih.gov/lexevscts2/valueset/CDISC Questionnaire Category Terminology/definition/f8af9058"
            {
             },
   "assertedBy": {
                    "mapVersionvalueSet": {
                            "content": "MA_to_NCIt_Mapping-1.0",CDISC Questionnaire Category Terminology"
                        "href": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/MA_to_NCIt_Mapping/version/1.0"}
                    },
                    "mapresolvedUsingCodeSystem": {[
                        "content": "MA_to_NCIt_Mapping",
{
                            "hrefversion": "https://lexevscts2.nci.nih.gov/lexevscts2/map/MA_to_NCIt_Mapping"
{
                     }
           "content": "NCI_Thesaurus-17.06d"
     },
                      "mapFrom": {
  },
                   "uri": "http://www.w3.org/ns/ma-ont#MA:0000002",
        "codeSystem": {
           "namespace": "MA",
                    "namecontent": "MA:0000002"NCI_Thesaurus",
                },
                "hrefuri": "httpshttp://lexevscts2ncicb.nci.nih.gov/lexevscts2xml/map/MA_to_NCIt_Mapping/version/MA_to_NCIt_Mapping-1.0/entry/MA:MA%253A0000002",owl/EVS/Thesaurus.owl#"
                "resourceName": "MA:MA%253A0000002"
            },
            {
            }
     "assertedBy": {
              ]
      "mapVersion": {
         }
            },
   "content": "MA_to_NCIt_Mapping-1.0",
        {
                "href": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/MA_to_NCIt_Mapping/version/1.0"valueset/CDISC SDTM Relationship to Subject Terminology/definition/986819bd/resolution/1",
                "resolvedValueSetURI": "http://evs.nci.nih.gov/valueset/C100130",
                    },"resolvedHeader": {
                    "mapresolutionOf": {
                        "contentvalueSetDefinition": "MA_to_NCIt_Mapping",
{
                            "hrefcontent": "https://lexevscts2.nci.nih.gov/lexevscts2/map/MA_to_NCIt_Mapping"986819bd",
                    }
                }"uri": "http://evs.nci.nih.gov/valueset/C100130",
                "mapFrom": {
                    "uri"href": "httphttps://wwwlexevscts2.nci.w3.org/ns/ma-ont#MA:0000003",nih.gov/lexevscts2/valueset/CDISC SDTM Relationship to Subject Terminology/definition/986819bd"
                    "namespace": "MA"    },
                        "namevalueSet": "MA:0000003"{
                },
                "hrefcontent": "https://lexevscts2.nci.nih.gov/lexevscts2/map/MA_to_NCIt_Mapping/version/MA_to_NCIt_Mapping-1.0/entry/MA:MA%253A0000003",
     CDISC SDTM Relationship to Subject Terminology"
           "resourceName": "MA:MA%253A0000003"
            },
            {
                "assertedBy": {},
                    "mapVersionresolvedUsingCodeSystem": {[
                         "content": "MA_to_NCIt_Mapping-1.0",
{
                            "hrefversion": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/MA_to_NCIt_Mapping/version/1.0"
 {
                   },
             "content": "NCI_Thesaurus-17.06d"
      "map": {
                     },
   "content": "MA_to_NCIt_Mapping",
                        "hrefcodeSystem": "https://lexevscts2.nci.nih.gov/lexevscts2/map/MA_to_NCIt_Mapping"{
                    }
                },
  "content": "NCI_Thesaurus",
              "mapFrom": {
                    "uri": "http://wwwncicb.nci.w3.org/ns/ma-ont#MA:0000004",nih.gov/xml/owl/EVS/Thesaurus.owl#"
                    "namespace": "MA",
       }
             "name": "MA:0000004"
          }
      },
                "href": "https://lexevscts2.nci.nih.gov/lexevscts2/map/MA_to_NCIt_Mapping/version/MA_to_NCIt_Mapping-1.0/entry/MA:MA%253A0000004",
  ]
              "resourceName": "MA:MA%253A0000004"  }
            }
        ],
        "complete": "PARTIAL",
        "numEntries": 3,
        "next": "https://lexevscts2.nci.nih.gov/lexevscts2/map/MA_to_NCIt_Mapping/version/MA_to_NCIt_Mapping-1.0/entriesresolvedvaluesets?page=1&format=json&maxtoreturn=3",
        "heading": {
            "resourceRoot": "https://lexevscts2.nci.nih.gov/lexevscts2/",
            "resourceURI": "map/MA_to_NCIt_Mapping/version/MA_to_NCIt_Mapping-1.0/entriesresolvedvaluesets",
            "parameter": [
                {
                    "arg": "maxtoreturn",
                    "val": "3"
                },
                {
                    "arg": "format",
                    "val": "json"
                }
            ],
            "accessDate": "2017-08-04T17:28:42.923-04:00"
        }
    }

}

Map Entry

Restrict to/from entity code system

Code Block
http://<base url>/map/NCIt_to_ICD9CM_Mapping/version/NCIt_to_ICD9CM_Mapping-1.0/entry/NCI_Thesaurus:C26913

Output

Code Block
collapsetrue
<MapEntryMsg xmlns="http://schema.omg.org/spec/CTS2/1.0/MapVersion" xmlns:core="http://schema.omg.org/spec/CTS2/1.0/Core"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://schema.omg.org/spec/CTS2/1.0/MapVersion http://www.omg.org/spec/cts2/201206/mapversion/MapVersion.xsd">
<core:heading>
<core:resourceRoot>
map/NCIt_to_ICD9CM_Mapping/version/NCIt_to_ICD9CM_Mapping-1.0/entry/NCI_Thesaurus:C26913
</core:resourceRoot>


<core:resourceURI>
http://<base url>/map/NCIt_to_ICD9CM_Mapping/version/NCIt_to_ICD9CM_Mapping-1.0/entry/NCI_Thesaurus:C26913
</core:resourceURI>


<core:accessDate>2013-09-20T16:23:22.120-05:00</core:accessDate>

</core:heading>


<entry entryState="ACTIVE" processingRule="ALL_MATCHES">
<assertedBy>
<core:mapVersion href="http://<base url>/codesystem/NCIt_to_ICD9CM_Mapping/version/1.0">NCIt_to_ICD9CM_Mapping-1.0</core:mapVersion>
<core:map href="http://<base url>/map/NCIt_to_ICD9CM_Mapping">NCIt_to_ICD9CM_Mapping</core:map>

</assertedBy>


<mapFrom uri="http://ncicb.nci.nih.gov/xml/owl/EVS/Thesaurus.owl#C26913">
<core:namespace>NCI_Thesaurus</core:namespace>
<core:name>C26913</core:name>

</mapFrom>


<mapSet processingRule="ALL_MATCHES" entryOrder="1">
<mapTarget entryOrder="1">
<mapTo uri="ICD_9_CM/78.12">
<core:namespace>ICD_9_CM</core:namespace>
<core:name>78.12</core:name>

</mapTo>



</mapTarget>



</mapSet>



</entry>



</MapEntryMsg>

Map Version Query

Returns a range of Maps for a text match on the resourceSynopsis

Code Block
http://<base url>/mapversions?matchvalue=ncit&filtercomponent=resourceSynopsis

Output

Code Block
languagehtml/xml
collapsetrue
<MapVersionDirectory xmlns="http://schema.omg.org/spec/CTS2/1.0/MapVersion" xmlns:core="http://schema.omg.org/spec/CTS2/1.0/Core" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://schema.omg.org/spec/CTS2/1.0/MapVersion http://www.omg.org/spec/cts2/201206/mapversion/MapVersion.xsd" complete="COMPLETE" numEntries="1">
<core:heading>
<core:resourceRoot>mapversions</core:resourceRoot>
<core:resourceURI>http://<base url>/mapversions</core:resourceURI>
<core:parameter arg="filtercomponent">
<core:val>resourceSynopsis</core:val>

</core:parameter>


<core:parameter arg="matchvalue">
<core:val>ncit</core:val>

</core:parameter>


<core:accessDate>2013-09-13T16:42:40.861-05:00</core:accessDate>

</core:heading>


<entry href="http://<base url>/map/NCIt_to_ICD9CM_Mapping/version/NCIt_to_ICD9CM_Mapping-1.0" about="urn:oid:NCIt_to_ICD9CM_Mapping" formalName="NCIt to ICD9CM Mapping"documentURI="urn:oid:NCIt_to_ICD9CM_Mapping" mapVersionName="NCIt_to_ICD9CM_Mapping-1.0">
<core:resourceSynopsis>
<core:value>NCIt_to_ICD9CM_Mapping</core:value>

</core:resourceSynopsis>


<versionOf uri="urn:oid:NCIt_to_ICD9CM_Mapping" href="http://<base url>/map/NCIt_to_ICD9CM_Mapping">NCIt_to_ICD9CM_Mapping</versionOf>

</entry>



</MapVersionDirectory>

Map Versions

Of a single code system

Code Block
http://<base url>/map/NCIt_to_ICD9CM_Mapping/versions

Output

Code Block
collapsetrue
<MapVersionDirectory xmlns="http://schema.omg.org/spec/CTS2/1.0/MapVersion" xmlns:core="http://schema.omg.org/spec/CTS2/1.0/Core"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://schema.omg.org/spec/CTS2/1.0/MapVersion http://www.omg.org/spec/cts2/201206/mapversion/MapVersion.xsd" complete="COMPLETE" numEntries="1">  <core:heading> <core:resourceRoot>map/NCIt_to_ICD9CM_Mapping/versions</core:resourceRoot>  <core:resourceURI>http://<base url>/map/NCIt_to_ICD9CM_Mapping/versions</core:resourceURI> <core:accessDate>2013-09-20T16:43:00.157-05:00</core:accessDate> </core:heading>  <entry href="http://<base url>/map/NCIt_to_ICD9CM_Mapping/version/NCIt_to_ICD9CM_Mapping-1.0" about="urn:oid:NCIt_to_ICD9CM_Mapping"formalName="NCIt to ICD9CM Mapping" documentURI="urn:oid:NCIt_to_ICD9CM_Mapping" mapVersionName="NCIt_to_ICD9CM_Mapping-1.0">  <core:resourceSynopsis> <core:value>NCIt_to_ICD9CM_Mapping</core:value> </core:resourceSynopsis> <versionOf uri="urn:oid:NCIt_to_ICD9CM_Mapping" href="http://<base url>/map/NCIt_to_ICD9CM_Mapping">NCIt_to_ICD9CM_Mapping</versionOf> </entry> </MapVersionDirectory>

Map Restriction to Role

To/From mapping example (Also MAP_FROM_ROLE)

Code Block
http://<base url>/mapversions?codesystem=ICD9CM&codesystemsmaprole=MAP_TO_ROLE

Output

Code Block
collapsetrue
<MapVersionDirectory xmlns="http://schema.omg.org/spec/CTS2/1.0/MapVersion" xmlns:core="http://schema.omg.org/spec/CTS2/1.0/Core"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://schema.omg.org/spec/CTS2/1.0/MapVersion http://www.omg.org/spec/cts2/201206/mapversion/MapVersion.xsd" complete="COMPLETE" numEntries="2">
<core:heading>
<core:resourceRoot>mapversions</core:resourceRoot>
<core:resourceURI>http://<base url>/mapversions</core:resourceURI>
<core:parameter arg="codesystem">
<core:val>ICD9CM</core:val>

</core:parameter>


<core:parameter arg="codesystemsmaprole">
<core:val>MAP_TO_ROLE</core:val>

</core:parameter>


<core:accessDate>2013-09-20T16:48:17.869-05:00</core:accessDate>

</core:heading>


<entry href="http://<base url>/map/MDR:MDR12_1_TO_ICD9CM:ICD9CM_1998/version/MDR:MDR12_1_TO_ICD9CM:ICD9CM_1998-200909"about="urn:oid:CL413320.MDR.ICD9CM" formalName="MDR:MDR12_1_TO_ICD9CM:ICD9CM_1998" documentURI="urn:oid:CL413320.MDR.ICD9CM"mapVersionName="MDR:MDR12_1_TO_ICD9CM:ICD9CM_1998-200909">
<versionOf uri="urn:oid:CL413320.MDR.ICD9CM"href="http://<base url>/map/MDR:MDR12_1_TO_ICD9CM:ICD9CM_1998">MDR:MDR12_1_TO_ICD9CM:ICD9CM_1998</versionOf>

</entry>


<entry href="http://<base url>/map/SNOMEDCT_2010_01_31_TO_ICD9CM_2010/version/SNOMEDCT_2010_01_31_TO_ICD9CM_2010-20100131"about="urn:oid:C2733618.SNOMEDCT.ICD9CM" formalName="SNOMEDCT_2010_01_31_TO_ICD9CM_2010" documentURI="urn:oid:C2733618.SNOMEDCT.ICD9CM"mapVersionName="SNOMEDCT_2010_01_31_TO_ICD9CM_2010-20100131">
<versionOf uri="urn:oid:C2733618.SNOMEDCT.ICD9CM"href="http://<base url>/map/SNOMEDCT_2010_01_31_TO_ICD9CM_2010">SNOMEDCT_2010_01_31_TO_ICD9CM_2010</versionOf>

</entry>



</MapVersionDirectory>

Map To/From or Both

Map to or from an entity or use MAP_FROM_BOTH

Code Block
http://<base url>/mapversions?entity=22298006&entitiesmaprole=MAP_FROM_ROLE

Output

Code Block
collapsetrue
<MapVersionDirectory xmlns="http://schema.omg.org/spec/CTS2/1.0/MapVersion" xmlns:core="http://schema.omg.org/spec/CTS2/1.0/Core"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://schema.omg.org/spec/CTS2/1.0/MapVersion http://www.omg.org/spec/cts2/201206/mapversion/MapVersion.xsd" complete="COMPLETE" numEntries="1">
<core:heading>
<core:resourceRoot>mapversions</core:resourceRoot>
<core:resourceURI>http://<base url>/mapversions</core:resourceURI>
<core:parameter arg="entity">
<core:val>22298006</core:val>

</core:parameter>


<core:parameter arg="entitiesmaprole">
<core:val>MAP_FROM_ROLE</core:val>

</core:parameter>


<core:accessDate>2013-09-20T16:52:41.500-05:00</core:accessDate>

</core:heading>


<entry href="http://<base url>/map/SNOMEDCT_2010_01_31_TO_ICD9CM_2010/version/SNOMEDCT_2010_01_31_TO_ICD9CM_2010-20100131"about="urn:oid:C2733618.SNOMEDCT.ICD9CM" formalName="SNOMEDCT_2010_01_31_TO_ICD9CM_2010" documentURI="urn:oid:C2733618.SNOMEDCT.ICD9CM"mapVersionName="SNOMEDCT_2010_01_31_TO_ICD9CM_2010-20100131">
<versionOf uri="urn:oid:C2733618.SNOMEDCT.ICD9CM"href="http://<base url>/map/SNOMEDCT_2010_01_31_TO_ICD9CM_2010">SNOMEDCT_2010_01_31_TO_ICD9CM_2010</versionOf>

</entry>



</MapVersionDirectory>

ResolvedValueSet Summaries

Returns all resolved value set entries with the option to page. (Place number or iteration are both possible on pagination.)

Code Block
http://<base url>/resolvedvaluesets

Output

Code Block
collapsetrue
<ResolvedValueSetDirectory xmlns="http://schema.omg.org/spec/CTS2/1.0/ValueSetDefinition" xmlns:core="http://schema.omg.org/spec/CTS2/1.0/Core"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://schema.omg.org/spec/CTS2/1.0/ValueSetDefinition http://www.omg.org/spec/cts2/201206/valuesetdefinition/ValueSetDefinition.xsd" complete="PARTIAL" numEntries="50" next="http://<base url>/resolvedvaluesets?page=1&maxtoreturn=50">
<core:heading>
<core:resourceRoot>resolvedvaluesets</core:resourceRoot>
<core:resourceURI>http://<base url>/resolvedvaluesets</core:resourceURI>
<core:accessDate>2013-09-13T16:21:52.001-05:00</core:accessDate>

</core:heading>


<entry resolvedValueSetURI="http://ncit:C81223" href="http://<base url>/valueset/CDISC ADaM Date Imputation Flag Terminology/definition/c38261e5/resolution/1">
<resolvedHeader>
<resolutionOf>
<core:valueSetDefinition uri="http://ncit:C81223" href="http://<base url>/valueset/CDISC ADaM Date Imputation Flag Terminology/definition/c38261e5">c38261e5</core:valueSetDefinition>
<core:valueSet>CDISC ADaM Date Imputation Flag Terminology</core:valueSet>

</resolutionOf>



</resolvedHeader>



</entry>


<entry resolvedValueSetURI="http://ncit:C81224" href="http://<base url>/valueset/CDISC ADaM Derivation Type Terminology/definition/5de6f446/resolution/1">
<resolvedHeader>
<resolutionOf>
<core:valueSetDefinition uri="http://ncit:C81224" href="http://<base url>/valueset/CDISC ADaM Derivation Type Terminology/definition/5de6f446">5de6f446</core:valueSetDefinition>
<core:valueSet>CDISC ADaM Derivation Type Terminology</core:valueSet>

</resolutionOf>



</resolvedHeader>



</entry>


<entry resolvedValueSetURI="http://ncit:C81225" href="http://<base url>/valueset/CDISC ADaM Parameter Type Terminology/definition/2ae1c4d0/resolution/1">
<resolvedHeader>
<resolutionOf>
<core:valueSetDefinition uri="http://ncit:C81225" href="http://<base url>/valueset/CDISC ADaM Parameter Type Terminology/definition/2ae1c4d0">2ae1c4d0</core:valueSetDefinition>
<core:valueSet>CDISC ADaM Parameter Type Terminology</core:valueSet>

</resolutionOf>



</resolvedHeader>



</entry>


ResolvedValueSet Query

Returns a set of Resolved Value Sets based on a text match against resourceName component

Code Block
http://<base url>/resolvedvaluesets?matchvalue=imputation&filtercomponent=resourceName

Output

Code Block
collapsetrue
<ResolvedValueSetDirectory xmlns="http://schema.omg.org/spec/CTS2/1.0/ValueSetDefinition" xmlns:core="http://schema.omg.org/spec/CTS2/1.0/Core"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://schema.omg.org/spec/CTS2/1.0/ValueSetDefinition http://www.omg.org/spec/cts2/201206/valuesetdefinition/ValueSetDefinition.xsd" complete="COMPLETE" numEntries="2">
<core:heading>
<core:resourceRoot>resolvedvaluesets</core:resourceRoot>
<core:resourceURI>http://<base url>/resolvedvaluesets</core:resourceURI>
<core:parameter arg="filtercomponent">
<core:val>resourceName</core:val>

</core:parameter>


<core:parameter arg="matchvalue">
<core:val>imputation</core:val>

</core:parameter>


<core:accessDate>2013-09-13T16:28:10.888-05:00</core:accessDate>

</core:heading>


<entry resolvedValueSetURI="http://ncit:C81223" href="http://<base url>/valueset/CDISC ADaM Date Imputation Flag Terminology/definition/c38261e5/resolution/1">
<resolvedHeader>
<resolutionOf>
<core:valueSetDefinition uri="http://ncit:C81223" href="http://<base url>/valueset/CDISC ADaM Date Imputation Flag Terminology/definition/c38261e5">c38261e5</core:valueSetDefinition>
<core:valueSet>CDISC ADaM Date Imputation Flag Terminology</core:valueSet>

</resolutionOf>



</resolvedHeader>



</entry>


<entry resolvedValueSetURI="http://ncit:C81226" href="http://<base url>/valueset/CDISC ADaM Time Imputation Flag Terminology/definition/b3e8956a/resolution/1">
<resolvedHeader>
<resolutionOf>
<core:valueSetDefinition uri="http://ncit:C81226" href="http://<base url>/valueset/CDISC ADaM Time Imputation Flag Terminology/definition/b3e8956a">b3e8956a</core:valueSetDefinition>
<core:valueSet>CDISC ADaM Time Imputation Flag Terminology</core:valueSet>

</resolutionOf>



</resolvedHeader>



</entry>



</ResolvedValueSetDirectory>

ResolvedValueSetDefinition Resolution

Returns the entries from terminology values in this value set

Code Block
http://<base url>/valueset/NICHD Newborn Screening Terminology/definition/4125c982/resolution/1

Output

Code Block
collapsetrue
<IteratableResolvedValueSet xmlns="http://schema.omg.org/spec/CTS2/1.0/ValueSetDefinition" xmlns:core="http://schema.omg.org/spec/CTS2/1.0/Core"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://schema.omg.org/spec/CTS2/1.0/ValueSetDefinition http://www.omg.org/spec/cts2/201206/valuesetdefinition/ValueSetDefinition.xsd" complete="PARTIAL" numEntries="50" next="http://<base url>/valueset/NICHD Newborn Screening Terminology/definition/4125c982/resolution/1?page=1&maxtoreturn=50">
<core:heading>
<core:resourceRoot>
valueset/NICHD Newborn Screening Terminology/definition/4125c982/resolution/1
</core:resourceRoot>


<core:resourceURI>
http://<base url>/valueset/NICHD Newborn Screening Terminology/definition/4125c982/resolution/1
</core:resourceURI>


<core:accessDate>2013-09-13T16:54:52.357-05:00</core:accessDate>

</core:heading>


<resolutionInfo>
<resolutionOf>
<core:valueSetDefinition uri="http://ncit:C89506" href="http://<base url>/valueset/NICHD Newborn Screening Terminology/definition/4125c982">4125c982</core:valueSetDefinition>
<core:valueSet>NICHD Newborn Screening Terminology</core:valueSet>

</resolutionOf>



</resolutionInfo>


<entry uri="http://ncicb.nci.nih.gov/xml/owl/EVS/Thesaurus.owl#C16847" href="http://<base url>/codesystem/NCI_Thesaurus/version/10.07e/entity/NCI_Thesaurus:C16847">
<core:namespace>NCI_Thesaurus</core:namespace>
<core:name>C16847</core:name>
<core:designation>Technique</core:designation>

</entry>


<entry uri="http://ncicb.nci.nih.gov/xml/owl/EVS/Thesaurus.owl#C34816" href="http://<base url>/codesystem/NCI_Thesaurus/version/10.07e/entity/NCI_Thesaurus:C34816">
<core:namespace>NCI_Thesaurus</core:namespace>
<core:name>C34816</core:name>
<core:designation>Congenital Metabolic Disorder</core:designation>

</entry>


<entry uri="http://ncicb.nci.nih.gov/xml/owl/EVS/Thesaurus.owl#C81178" href="http://<base url>/codesystem/NCI_Thesaurus/version/10.07e/entity/NCI_Thesaurus:C81178">
<core:namespace>NCI_Thesaurus</core:namespace>
<core:name>C81178</core:name>
<core:designation>Newborn Screening</core:designation>

</entry>


<entry uri="http://ncicb.nci.nih.gov/xml/owl/EVS/Thesaurus.owl#C50644" href="http://<base url>/codesystem/NCI_Thesaurus/version/10.07e/entity/NCI_Thesaurus:C50644">
<core:namespace>NCI_Thesaurus</core:namespace>
<core:name>C50644</core:name>
<core:designation>Lung Overinflation</core:designation>

</entry>


<entry uri="http://ncicb.nci.nih.gov/xml/owl/EVS/Thesaurus.owl#C13235" href="http://<base url>/codesystem/NCI_Thesaurus/version/10.07e/entity/NCI_Thesaurus:C13235">
<core:namespace>NCI_Thesaurus</core:namespace>
<core:name>C13235</core:name>
<core:designation>Fetus</core:designation>

</entry>



"val": "json"
                }
            ],
            "accessDate": "2017-08-07T11:32:07.923-04:00"
        }
    }

} 

ResolvedValueSet Query

Returns a set of Resolved Value Sets based on a text match against resourceName component

Code Block
http://<base url>/resolvedvaluesets?matchvalue=imputation&filtercomponent=resourceName&format=json

Output

Code Block
collapsetrue
{

    "ResolvedValueSetDirectory": {
        "entry": [
            {
                "href": "https://lexevscts2.nci.nih.gov/lexevscts2/valueset/CDISC ADaM Date Imputation Flag Terminology/definition/2856f3ed/resolution/1",
                "resolvedValueSetURI": "http://evs.nci.nih.gov/valueset/C81223",
                "resolvedHeader": {
                    "resolutionOf": {
                        "valueSetDefinition": {
                            "content": "2856f3ed",
                            "uri": "http://evs.nci.nih.gov/valueset/C81223",
                            "href": "https://lexevscts2.nci.nih.gov/lexevscts2/valueset/CDISC ADaM Date Imputation Flag Terminology/definition/2856f3ed"
                        },
                        "valueSet": {
                            "content": "CDISC ADaM Date Imputation Flag Terminology"
                        }
                    },
                    "resolvedUsingCodeSystem": [
                        {
                            "version": {
                                "content": "NCI_Thesaurus-17.06d"
                            },
                            "codeSystem": {
                                "content": "NCI_Thesaurus",
                                "uri": "http://ncicb.nci.nih.gov/xml/owl/EVS/Thesaurus.owl#"
                            }
                        }
                    ]
                }
            },
            {
                "href": "https://lexevscts2.nci.nih.gov/lexevscts2/valueset/CDISC ADaM Time Imputation Flag Terminology/definition/583c0762/resolution/1",
                "resolvedValueSetURI": "http://evs.nci.nih.gov/valueset/C81226",
                "resolvedHeader": {
                    "resolutionOf": {
                        "valueSetDefinition": {
                            "content": "583c0762",
                            "uri": "http://evs.nci.nih.gov/valueset/C81226",
                            "href": "https://lexevscts2.nci.nih.gov/lexevscts2/valueset/CDISC ADaM Time Imputation Flag Terminology/definition/583c0762"
                        },
                        "valueSet": {
                            "content": "CDISC ADaM Time Imputation Flag Terminology"
                        }
                    },
                    "resolvedUsingCodeSystem": [
                        {
                            "version": {
                                "content": "NCI_Thesaurus-17.06d"
                            },
                            "codeSystem": {
                                "content": "NCI_Thesaurus",
                                "uri": "http://ncicb.nci.nih.gov/xml/owl/EVS/Thesaurus.owl#"
                            }
                        }
                    ]
                }
            }
        ],
        "complete": "COMPLETE",
        "numEntries": 2,
        "heading": {
            "resourceRoot": "https://lexevscts2.nci.nih.gov/lexevscts2/",
            "resourceURI": "resolvedvaluesets",
            "parameter": [
                {
                    "arg": "matchvalue",
                    "val": "imputation"
                },
                {
                    "arg": "filtercomponent",
                    "val": "resourceName"
                },
                {
                    "arg": "format",
                    "val": "json"
                }
            ],
            "accessDate": "2017-08-07T11:36:37.852-04:00"
        }
    }

}

ResolvedValueSetDefinition Resolution

Returns the entries from terminology values in this value set.

Code Block
http://<base url>/valueset/CDISC ADaM Date Imputation Flag Terminology/definition/2856f3ed/resolution/1?format=json

Output

Code Block
collapsetrue
{
    "IteratableResolvedValueSet": {
        "resolutionInfo": {
            "resolutionOf": {
                "valueSetDefinition": {
                    "content": "2856f3ed",
                    "uri": "http://evs.nci.nih.gov/valueset/C81223",
                    "href": "https://lexevscts2.nci.nih.gov/lexevscts2/valueset/CDISC ADaM Date Imputation Flag Terminology/definition/2856f3ed"
                },
                "valueSet": {
                    "content": "CDISC ADaM Date Imputation Flag Terminology"
                }
            },
            "resolvedUsingCodeSystem": [
                {
                    "version": {
                        "content": "NCI_Thesaurus-17.06d"
                    },
                    "codeSystem": {
                        "content": "NCI_Thesaurus",
                        "uri": "http://ncicb.nci.nih.gov/xml/owl/EVS/Thesaurus.owl#"
                    }
                }
            ]
        },
        "entry": [
            {
                "uri": "http://ncicb.nci.nih.gov/xml/owl/EVS/Thesaurus.owl#C81210",
                "href": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurus/version/17.06d/entity/NCI_Thesaurus:C81210",
                "namespace": "NCI_Thesaurus",
                "name": "C81210",
                "designation": "Year Month Day Imputed"
            },
            {
                "uri": "http://ncicb.nci.nih.gov/xml/owl/EVS/Thesaurus.owl#C81211",
                "href": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurus/version/17.06d/entity/NCI_Thesaurus:C81211",
                "namespace": "NCI_Thesaurus",
                "name": "C81211",
                "designation": "Month Day Imputed"
            },
            {
                "uri": "http://ncicb.nci.nih.gov/xml/owl/EVS/Thesaurus.owl#C81212",
                "href": "https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurus/version/17.06d/entity/NCI_Thesaurus:C81212",
                "namespace": "NCI_Thesaurus",
                "name": "C81212",
                "designation": "Day Imputed"
            }
        ],
        "complete": "COMPLETE",
        "numEntries": 3,
        "heading": {
            "resourceRoot": "https://lexevscts2.nci.nih.gov/lexevscts2/",
            "resourceURI": "valueset/CDISC ADaM Date Imputation Flag Terminology/definition/2856f3ed/resolution/1",
            "parameter": [
                {
                    "arg": "format",
                    "val": "json"
                }
            ],
            "accessDate": "2017-08-07T11:38:21.389-04:00"
        }
    }

}

CTS2 Bulk Term Download Extension

LexEVS 6.1 features a bulk download REST interface that is an extension to the LexEVS CTS2 service. It provides users with the ability to download entire term sets from a given coding scheme or map to a text file

Code Systems Bulk Download

Example

Map Bulk Download

Example

Parameters for Rest Call

URL:

  • /lexevscts2/exporter/codingscheme or
  • /lexevscts2/exporter/map

Parameters:

codingschemes or map - (Optional) CodingSchemes or map to include (comma-separated). Default: all

fields - (Optional) Content fields to output. Default: [code, namespace, description, codingschemename, codingschemeuri, codingschemeversion]

separator -(Optional) One character field separator. Default: |

filename - (Optional) Output file name. Default: terminology-bulk-download.txt

Scrollbar
iconsfalse

 

  Scrollbariconsfalse