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.

UMLS REST API Home Page

Authentication Service Endpoint

The authentication service provides methods for retrieving a ticket granting ticket as well as single-use service tickets.
Service tickets are needed each time you search or retrieve content from the UMLS REST API.
For help with making authentication calls using Postman, see our tutorial: UMLS REST API: Authentication and Calling.

Base URI Method Type Path Description
https://utslogin.nlm.nih.gov
POST /cas/v1/tickets Retrieves a Ticket Granting Ticket (TGT)
POST /cas/v1/tickets/{TGT} Retrieves a single-use Service Ticket

Endpoints to search and retrieve UMLS content

Base URI HTTP Request Type Path Description
https://uts-ws.nlm.nih.gov/rest
GET /search/{version} Retrieves CUIs when searching by term or code
GET /content/{version}/CUI/{CUI} Retrieves information about a known CUI
GET /content/{version}/CUI/{CUI}/atoms Retrieves atoms and information about atoms for a known CUI
GET /content/{version}/CUI/{CUI}/definitions Retrieves definitions for a known CUI
GET /content/{version}/CUI/{CUI}/relations Retrieves NLM-asserted relationships for a known CUI
GET /content/{version}/source/{source}/{id} Retrieves information about a known source-asserted identifier
GET /content/{version}/source/{source}/{id}/atoms Retrieves information about atoms for a known source-asserted identifier
GET /content/{version}/source/{source}/{id}/parents Retrieves immediate parents of a source-asserted identifier
GET /content/{version}/source/{source}/{id}/children Retrieves immediate children of a source-asserted identifier
GET /content/{version}/source/{source}/{id}/ancestors Retrieves all ancestors of a source-asserted identifier
GET /content/{version}/source/{source}/{id}/descendants Retrieves all descendants of a source-asserted identifier
GET /content/{version}/source/{source}/{id}/relations Retrieves all relationships of a source-asserted identifier
GET /subsets/{version}/ Retrieves all available source-asserted subsets
GET /subsets/{version}/source/{source}/{id} Retrieves information about a specific source-asserted subset
GET /subsets/{version}/source/{source}/{id}/members Retrieves members of a specific source-asserted subset
GET /subsets/{version}/source/{source}/{id}/member/{id} Retrieves an individual member of a specific source-asserted subset
GET /content/{version}/source/{source}/{id}/attributes Retrieves information about source-asserted attributes
GET /semantic-network/{version}/TUI/{id} Retrieves information for a known Semantic Type identifier (TUI)
GET /content-views/{version} Retrieve all available content views in the UMLS
GET /content-views/{version}/CUI/{CUI} Retrieve information about a specific content view
GET /content-views/{version}/CUI/{CUI}/members Retrieve members of a specific content view
GET /content-views/{version}/CUI/{CUI}/member/{id} Retrieves an individual member of a specific content view
GET /crosswalk/{version}/source/{source}/{id} Retrieves all source-asserted identifiers that share a UMLS CUI with a particular code