UTS Logo

UMLS API Technical Documentation

Current REST API Version: 0.63 beta

We welcome your feedback on our customer service form. Please use "UMLS REST API feedback" in your subject line.
Gotta question for other UMLS users? Join the UMLS listserv.
Check out the Postman sample collections, or code samples in Python, Java, and Perl on Github to help you get started using the UMLS REST API.

Retrieving Semantic Type Information

The /semantic-network endpoint supports the retrieval of semantic type information by identifier.
UMLS CUIs are assigned semantic types. When you make a call to the /CUI/{CUI} service, you will receive back semantic type
information as part of your Concept object.

Use https://uts-ws.nlm.nih.gov/rest/semantic-network as your base URI.

Sample URI Description Returned JSON Object classType
/semantic-network/current/TUI/T109 Retrieves TUI SemanticType

Query Parameters

Parameter name Required? Y/N Description Valid Values Default value Usage Note
ticket Y A single-use service ticket is required for each call to the API. See authentication for more information n/a n/a n/a

Sample output for https://uts-ws.nlm.nih.gov/rest/semantic-network/2015AB/TUI/T109?ticket=ST-…

Sample Output

   pageSize: 25,
   pageNumber: 1,
   pageCount: 1,
   result: {
        classType: "SemanticType",
        abbreviation: "orch",
        ui: "T109",
        definition: "The general class of carbon-containing compounds, usually based on carbon chains or rings, and also containing hydrogen (hydrocarbons), with or without nitrogen, oxygen, or other elements in which the bonding between elements is generally covalent.",
        example: "NONE",
        nonHuman: "NONE",
        usageNote: "Salts of organic chemicals (such as Calcium Acetate) would be considered organic chemicals and should not also receive the type 'Inorganic Chemical'.",
        treeNumber: "A1.",
        semanticTypeGroup: {
            classType: "SemanticGroup",
            abbreviation: "CHEM",
            expandedForm: "Chemicals & Drugs",
            semanticTypeCount: 20
        childCount: 2,
        name: "Organic Chemical"