LexEVS Data Services to be discontinued.

The caCORE type REST queries will be discontinued with the LexEVS 6.5 release.  The CTS2 will replace the previous REST services.  Please replace your old queries with the listed examples.

Get CodingScheme details

If a version is not included then LexEVS will look for a version tagged as "PRODUCTION". If no such coding scheme exists then an error will be returned.

https://lexevsapi6.nci.nih.gov/lexevsapi64/GetXML?query=org.LexGrid.codingSchemes.CodingScheme&org.LexGrid.codingSchemes.CodingScheme&codingSchemeName=Zebrafish
https://lexevscts2.nci.nih.gov/lexevscts2/codesystemversions?matchvalue=Zebrafish&format=xml

 

 

Note that you could also add a version to a URL targeting a specific load in LexEVS. The following example shows the form to target the November_24_2016 version of the Zebrafish terminology.

https://lexevsapi6.nci.nih.gov/lexevsapi64/GetXML?query=org.LexGrid.codingSchemes.CodingScheme&org.LexGrid.codingSchemes.CodingScheme&codingSchemeName=Zebrafish&codingSchemeVersion=November_24_2016
https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/Zebrafish/version/November_24_2016?format=xml

 

The information can also be returned as JSON.

https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurus/version/17.01e?format=json


The GetHTML function is not supported in CTS2

https://lexevsapi6.nci.nih.gov/lexevsapi64/GetHTML?query=org.LexGrid.codingSchemes.CodingScheme&org.LexGrid.codingSchemes.CodingScheme&codingSchemeName=Zebrafish

 

Get Concept by Code

http://lexevsapi6.nci.nih.gov/lexevsapi64/GetXML?query=org.LexGrid.concepts.Entity&org.LexGrid.concepts.Entity[@_entityCode=C33999]&codingSchemeName=NCI_Thesaurus
https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurus/entity/C33999

Get Concept by Code with wildcard  -  Not supported

Searching by code with wildcard is not supported in CTS2

http://lexevsapi6.nci.nih.gov/lexevsapi64/GetXML?query=org.LexGrid.concepts.Entity&org.LexGrid.concepts.Entity[@_entityCode=ZFA:000123*]&codingSchemeName=Zebrafish

 


Get Concept by EntityDescription

The old DataServices performed a strict exact match.  This query will return only one result

http://lexevsapi6.nci.nih.gov/lexevsapi64/GetXML?query=org.LexGrid.concepts.Entity,org.LexGrid.commonTypes.EntityDescription&org.LexGrid.commonTypes.EntityDescription[@_content=Heart]&codingSchemeName=NCI_Thesaurus

CTS2 does a tokenized exact match.  A concept where any one token is an exact match will be included in the result set.  As a result, this returns multiple concepts

http://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurus/entities?matchvalue=Heart&matchalgorith=exactMatch?format=xml

Get Concept by Code by EntityDescription with wildcard

https://lexevsapi6.nci.nih.gov/lexevsapi64/GetXML?query=org.LexGrid.concepts.Entity,org.LexGrid.commonTypes.EntityDescription&org.LexGrid.commonTypes.EntityDescription[@_content=He*rt*]&codingSchemeName=NCI_Thesaurus
https://lexevscts2.nci.nih.gov/lexevscts2/codesystem/NCI_Thesaurus/version/NCI_Thesaurus-17.01e/entities?matchalgorithm=luceneQuery&format=xml&matchvalue=He*rt

Get Concept by Presentation

http://lexevsapi60.nci.nih.gov/lexevsapi60/GetHTML?query=Concept,Presentation,Text&Text\[@_content=heart\]&codingSchemeName=Zebrafish

http://lexevsapi60.nci.nih.gov/lexevsapi60/GetHTML?query=Concept,Presentation,Text&Text[@_content=heart]&codingSchemeName=Zebrafish

Get Concept by Presentation with wildcard

http://lexevsapi60.nci.nih.gov/lexevsapi60/GetHTML?query=Concept,Presentation,Text&Text\[@_content=heart*\]&codingSchemeName=Zebrafish

http://lexevsapi60.nci.nih.gov/lexevsapi60/GetHTML?query=Concept,Presentation,Text&Text[@_content=heart*]&codingSchemeName=Zebrafish

Get Concept by Definition with wildcard

http://lexevsapi60.nci.nih.gov/lexevsapi60/GetHTML?query=Concept,Definition,Text&Text\[@_content=Bilateral%20groups%20of%20cells*\]&codingSchemeName=Zebrafish

http://lexevsapi60.nci.nih.gov/lexevsapi60/GetHTML?query=Concept,Definition,Text&Text[@_content=Bilateral%20groups%20of%20cells*]&codingSchemeName=Zebrafish

Show Presentations of a Concept

http://lexevsapi60.nci.nih.gov/lexevsapi60/GetHTML?query=org.LexGrid.concepts.Presentation&org.LexGrid.concepts.Entity\[@_entityCode=ZFA:0001234\]&roleName=_presentationList&codingSchemeName=Zebrafish

http://lexevsapi60.nci.nih.gov/lexevsapi60/GetHTML?query=org.LexGrid.concepts.Presentation&org.LexGrid.concepts.Entity[@_entityCode=ZFA:0001234]&roleName=_presentationList&codingSchemeName=Zebrafish

Show Definitions of a Concept

http://lexevsapi60.nci.nih.gov/lexevsapi60/GetHTML?query=org.LexGrid.concepts.Definition&org.LexGrid.concepts.Entity\[@_entityCode=ZFA:0001234\]&roleName=_definitionList&codingSchemeName=Zebrafish

http://lexevsapi60.nci.nih.gov/lexevsapi60/GetHTML?query=org.LexGrid.concepts.Definition&org.LexGrid.concepts.Entity[@_entityCode=ZFA:0001234]&roleName=_definitionList&codingSchemeName=Zebrafish

Show Supported Associations for a CodingScheme

http://lexevsapi60.nci.nih.gov/lexevsapi60/GetHTML?query=org.LexGrid.naming.SupportedAssociation&org.LexGrid.naming.SupportedAssociation&codingSchemeName=Zebrafish

http://lexevsapi60.nci.nih.gov/lexevsapi60/GetHTML?query=org.LexGrid.naming.SupportedAssociation&org.LexGrid.naming.SupportedAssociation&codingSchemeName=Zebrafish