This page describes the representational state transfer application programming interface (REST API) implementations that can be used to access TCIA data and resources. The APIs complement the existing web interfaces and enable developers to build direct access to TCIA data into their applications using only the API documentation provided. The application developer must ensure that they and the users of their applications comply with the TCIA Data Usage Policy.

TCIA currently offers the following RESTful interfaces to the search and download functions enabled by the National Biomedical Imaging Archive (NBIA) software in the TCIA radiology portal.

• TCIA REST APIs: Originally developed using Project Bindaas with Emory University, these APIs provide access to public collections and do not require authentication or API keys to use them. The TCIA REST API Guide describes these APIs.  
• NBIA REST APIs: Provided as part of the NBIA software, these APIs provide access to the search and download functions used in the TCIA radiology portal, and allow access to both public and limited access collections. The NBIA Search REST APIs allow you to perform basic queries and download data for image analysis on public collections. The NBIA Search with Authentication REST APIs allow you to perform basic queries on and download data for image analysis from public and restricted collections. The NBIA Advanced REST APIs also allow access to public and restricted collections, but are geared towards developers seeking to integrate searching and downloading TCIA data into their own web and desktop applications. 

Note that new versions of the APIs may introduce new data types that have not yet been documented. If you are interested in using the APIs and have any questions, please contact the TCIA Help Desk.

TCIA Data Usage Policy

Any user accessing TCIA data must agree to:

• Not use the requested datasets, either alone or in concert with any other information, to identify or contact individual participants from whom data and/or samples were collected and follow all other conditions specified in our Site Disclaimer. Approved Users also agree not to generate and use information (e.g., facial images or comparable representations) in a manner that could allow the identities of research participants to be readily ascertained. These provisions do not apply to research investigators operating with specific IRB approval, pursuant to 45 CFR 46, to contact individuals within datasets or to obtain and use identifying information under an IRB-approved research protocol. All investigators including any Approved User conducting “human subjects research” within the scope of 45 CFR 46 must comply with the requirements contained therein.
• Acknowledge in all oral or written presentations, disclosures, or publications the specific dataset(s) or applicable accession number(s) and the NIH-designated data repositories through which the investigator accessed any data. Citation guidelines for doing this are outlined below.
• If you are considering mirroring a copy of our publicly available datasets or providing direct access to any of our data via another tool or website using our REST API please review our Data Analysis Centers (DACs) page for more information. DACs must provide attribution and links back to this TCIA data usage policy and require downstream users to do the same.

The summary page for every TCIA dataset includes a Citations & Data Usage Policy tab (see screenshot below).  Please consult the Citation & Data Usage Policy for each Collection before using them.  

• Most data are freely available to browse, download, and use for commercial, scientific and educational purposes as outlined in the Creative Commons Attribution 3.0 Unported License or the Creative Commons Attribution 4.0 International License.  A small number of collections impose Creative Commons licenses with commercial use restrictions, but this is no longer an option for new submissions.
• Most data are immediately accessible and do not require account registration.  A small subset of collections do require registration and special permission to gain access. Refer to the "Access" column on https://www.cancerimagingarchive.net/collections/ for more details. Limited Access Collections are currently released under 1 of 2 custom license options:
  • TCIA Restricted License - NOTE: the commercial restriction option is no longer available for new data submissions
    • note: The previous TCIA Limited Access License was deprecated 05-19-2022.
  • NCTN Data Archive License (with collaborative agreement; with no collaborative agreement)

• TCIA takes every step possible to protect the privacy of participants that have agreed to share their data to promote cancer research. Therefore, effective January 6, 2022, all TCIA Collections of brain, head or head/neck cancers (where data could be used to reconstruct a human face) will change from a Creative Commons license to a TCIA Limited Access License. The data will still be available to download for research, but you will need a TCIA account and an approved License Agreement on file with the TCIA Help Desk.