...
Panel | ||||
---|---|---|---|---|
|
What's New
In July and August 2023, the following APIs were added to this guide.
- Cart Data
- Collection Descriptions
- Collection Site
- Manifest for Collection
- Manifest for Text Search
- Manifest from Patient Study Series
- MD5 Hierarchy
- Min Max Timepoints
- Restrictions for Text Search
Purpose of this Guide
The This guide explains the advanced features of the National Biomedical Imaging Archive (NBIA) REST APIs allow you to access the search and download functions used in the TCIA radiology portal. The NBIA Advanced REST APIs , described on this page, provide capabilities to access restricted collections, which require login authentication. They also provide advanced features that are geared towards developers seeking to integrate searching and downloading TCIA data into their own web and desktop applications.
...
NBIA Advanced REST API Base URL, Format, and Return Values
Access to any NBIA Advanced REST API requires an authentication token. If you want to access restricted collections, the TCIA Help Desk must give your user account permission to access them.
The full API for data consists of a base URL followed by The API structure consists of a base URL followed by the API and query parameters, in that order. The base URL to access NBIA Advanced REST API data is . For example, the AP
I shown below requests all Body Part Values and Counts for the PT modality.
Note: To accommodate special characters in passwords, use double quotes on Windows and single quotes on Mac and Linux.
Info | ||||
---|---|---|---|---|
| ||||
|
...
|
We can break this down as follows.
...
title | URLs to Access NLST Data |
---|
...
Object | Example |
---|---|
Access Token | cd2b2895-85d0-49c5-bd75-804f162da942 |
BaseURL | |
Resource |
/nbia-api/services |
...
icon | false |
---|---|
title | NBIA Advanced REST API Query Structure |
Code Block |
---|
<Token><BaseURL><Resource><QueryEndpoint>?<QueryParameters> |
For example, the API shown below requests all Body Part Values and Counts for the PT modality.
...
icon | false |
---|---|
title | Example NBIA Advanced REST API Query |
Code Block |
---|
curl -H "Authorization:Bearer cd2b2895-85d0-49c5-bd75-804f162da942" -k "https://services.cancerimagingarchive.net/nbia-api/services/getBodyPartValuesAndCounts?Modality=PT" |
Endpoint | getBodyPartValuesAndCounts |
Query Parameters | Modality=PT |
Note |
---|
If the value for an attribute is not populated in the specified collection, it will not appear in the returned values. |
All APIs return results in JSON format except for the Thumbnail API (JPG), Manifest Text API (TXT), and Series Metadata 2 API (CSV).
Secure Access to NBIA REST Services
Access to any NBIA Advanced REST API requires a token that you must request. This token can then be used on subsequent requests to authorize access to resources. This token will expire in two hours but you can refresh it.
The NBIA REST API supports secure access to private data in the Client Credentials authorization flow with Spring Security and OAuth2. The Client Credentials authorization flow is also known as "signed fetch" or 2-legged OAuth. The following figure illustrates the typical use case for REST API calls made on the web using 2-legged OAuth. For more information regarding the specific workflow, consult the OAuth2 Specification.
+--
We can break this down as follows.
...
https://services.cancerimagingarchive.net
...
Note |
---|
If the value for an attribute is not populated in the specified collection, it will not appear in the returned values. |
All APIs return results in JSON format except for the Thumbnail API (JPG), Manifest Text API (TXT), and Series Metadata API (CSV).
Secure Access to NBIA REST Services
Access to any NBIA Advanced REST API requires a token that you must request.
Note |
---|
The credentials you pass differ based on whether the collections include public or restricted data. You must contact the TCIA Help Desk for permission to access private collections and receive the client_id and client_secret values required for RESTful access to those collections. |
The NBIA REST API supports secure access to private data in the Client Credentials authorization flow with Spring Security and OAuth2. The Client Credentials authorization flow is also known as "signed fetch" or 2-legged OAuth. The following figure illustrates the typical use case for REST API calls made on the web using 2-legged OAuth. For more information regarding the specific workflow, consult the OAuth2 Specification.
+---------+ +---------------+
| | | |
| |>--(A)- Client Authentication --->| Authorization |
| Client | | Server |
| |<--(B)---- Access Token ---------<| |
| | | |
+---------+ +---------------+
Figure 1: Client Credentials Flow
This flow includes the following steps:
- The client authenticates with the authorization server and requests an access token from the token endpoint.
- The authorization server authenticates the client, and if valid, issues an access token.
This token can then be used on subsequent requests to authorize access to resources. The NBIA Advanced REST API server also supports token expiration and extension by refresh. The time it takes tokens to expire is currently two hours but is configurable.
To access TCIA using an NBIA Advanced REST API, you must do the following:
Requesting a Token
Access to any NBIA Advanced REST API requires an authentication token.
Requesting a Token
Access to any NBIA Advanced REST API requires an access token. A request for an access token takes the following structure. Note that USER should be your TCIA username and PASSWORD should be your TCIA password.
Note: To accommodate special characters in passwords, use double quotes on Windows and single quotes on Mac and LinuxA request for a token takes the following structure. Note that USERNAME should be your TCIA username and PASSWORD should be your TCIA password.
Code Block | ||
---|---|---|
| ||
curl -v -d "username=USERNAMEUSER&password=PASSWORD&client_id=NBIA&grant_type=password" -X POST -k https://services.cancerimagingarchive.net/nbia-api/oauth/token |
If you don't have a TCIA account and want to test an API, you can access public data using the NBIA "nbia_guest" account with no password, as follows.
Code Block | |||
---|---|---|---|
| |||
curl -vcurl -d "username=nbia_guest&password=&client_id=NBIA&grant_type=password" -X POST -k https://services.cancerimagingarchive.net/nbia-api/oauth/token |
Request a token by interacting with the application in the following way.
- The application requests credentials. The credentials you pass are different depending on if you want to access public or restricted data (see above).
The application sends a request to the service using the credentials you provided as a query string for the body.
- grant_type=password
- username
- password
The service responds with access token details and expiration information.
- access_token
- expires_in
- token_type
The application makes a request for resources using the returned access token. All APIs listed for accessing public data also support secure access to restricted data with an additional parameter for the access token.
How a Token is Returned/Granted/Given
A successful token request returns a standard access token in JSON format.
How a Token is Returned/Granted/Given
A successful token request returns a standard access token in JSON format. The value after "access_token" will be longer than this example.
Code Block | ||
---|---|---|
| ||
{"access_token":"cd2b2895-85d0-49c5-bd75-804f162da942","expires_in":7200,"refresh_expires_in":7200 | ||
Code Block | ||
| ||
{"access_token":"f7889076-b3e4-4768-9419-3cd973adda76","token_type":"bearer","refresh_token":"eyJhbGciOiJIUzI1NiIsInR5cCIgO","671bb72bnot-f929-4ef5-a4d7-b52341a6007a"before-policy":0,"expiressession_in":7199} |
Using the Token in an API Call
state":"92a199c6-84ed-48aa-a0d2-059bbb99bc90","scope":"openid profile email"} |
Make a note of the access token you received and pass it with the REST service call.
Code Block | ||
---|---|---|
| ||
# Request for modality values and counts curl -H "Authorization:Bearer c428d42ccd2b2895-9eed85d0-4f5d49c5-8007bd75-416d46be9b52804f162da942" -k "https://services.cancerimagingarchive.net/nbia-api/services/getModalityValuesAndCounts?Collection=LIDC-IDRI" |
A successful service request returns the value in a defined format.
...
Refreshing the Token
The time it takes tokens to expire is configurable but is currently two hoursYou can refresh your access token for an additional two hours by passing the refresh token from your original token request.
Code Block | ||
---|---|---|
| ||
# Request for refreshing the token $ curl -X -v -d "refresh_token=7c2414a1-1f2f-4c9e-82a0-69fcb9fd18ed& "client_id=nbiaRestAPIClient&client_secret=ItsBetweenUAndMe&nbia&grant_type=refresh_token&refresh_token=YOUR_REFRESH_TOKEN" -X POST -k https://servicesnbia.cancerimagingarchive.net/nbia-api/oauth/token /nbia-api/oauth/token" |
In the following result, 7200
is the In the following result, 119
is the seconds before the token expires.
Code Block | ||
---|---|---|
| ||
{"access_token":"YOUR_ACCESS_TOKEN","expires_in":7200,"refresh_expires_in":7200,"refresh_token":"bbe4aa2c-7235-41ad-9770-31619d3dbd15YOUR_REFRESH_TOKEN","token_type":"bearerBearer","refreshid_token":"YOUR_ID_TOKEN","not-before-policy":"671bb72b-f929-4ef5-a4d7-b52341a6007a","expires_in":119} |
Example Request to Logout
0,"session_state":"531425b6-425d-44f8-bc74-41200d6803c0","scope":"openid profile email"} |
Logging Out
The following is an example request to log out. Logging out invalidates the token you previously requested.
Code Block | ||
---|---|---|
| ||
Code Block | ||
| ||
# Request for logout curl -X $ curl -H-v -d "Authorization:Bearer caa278aa-e7a9-45b8-a7ec-2c83d4b03cc0YOUR_ACCESS_TOKEN" -k "https://services.cancerimagingarchive.net/nbia-api/logout" |
Result
Code Block | ||
---|---|---|
| ||
You Have Logged Out successfully. |
REST Advanced REST APIs
The TCIA Radiology Portal’s search features use the following Advanced REST APIs.
If the value for an attribute is null in the specified collection, it will not appear in the returned values.
...
maxLevel | 2 |
---|---|
location | top |
Body Part Values and Counts API
The Body Part Values and Counts API returns the modality values and body part count for the modality. It optionally takes the following parameters.
- Collection
- Modality
Example Body Part Values and Counts Query
...
title | Sample Call |
---|
...
The request does not return any values.
Accessing the National Lung Screening Trial (NLST) collection
Due to its size, the National Lung Screening Trial (NLST) collection lives on a separate NBIA server. Since this server only holds the public NLST collection, there is no reason to create an API token with your own credentials. To access these data via the Advanced REST API, you must change the URL to obtain the authentication token from https://nlst.cancerimagingarchive.net/nbia-api/oauth/token. You can then use https://nlst.cancerimagingarchive.net/nbia-api/services/ to make REST API calls. In both cases, the beginning of the URL is changed from "services" to "nlst." Examples of requesting a token and performing an API query are shown below:
Code Block | ||
---|---|---|
| ||
curl -X -v -d "username=nbia_guest&password=&client_id=NBIA&grant_type=password" -X POST -k https://nlst.cancerimagingarchive.net/nbia-api/oauth/token |
Code Block | ||
---|---|---|
| ||
curl -H "Authorization:Bearer YOUR_ACCESS_TOKEN" -k "https://nlst.cancerimagingarchive.net/nbia-api/services/getBodyPartValuesAndCounts?Modality=PT" |
Advanced REST APIs
The TCIA Radiology Portal’s search features use the following Advanced REST APIs.
Query Name | Return Values | Query Parameters |
---|---|---|
Body Part Values and Counts | Modality values and body part count for the modality API example and return values for getBodyPartValuesAndCounts |
|
Collection Descriptions | The collection's description | collectionName (O) |
Collection or Series for DOI | The collection and/or series with the Digital Object Identifier (DOI) API example and return values for getCollectionorSeriesforDOI |
|
Collection Values and Counts | The collections and the subject count for the collection API example and return values for getCollectionValuesandCounts | |
Create Saved Cart | Creates a saved cart (list) API example and return values for Create Saved Cart (createSharedList) |
|
DICOM Metadata by Series UID | Provides the functionality in the portal where the DICOM data is retrieved from a series | SeriesUID |
Extended Simple Search with Modality and Body Part Paged | API example and return values for getSimpleSearchWithModalityAndBodyPartPaged |
|
Image with MD5 Hash | Zip file with the images and a CSV file containing the MD5 hashes | SeriesInstanceUID |
Manifest for Simple Search | The Manifest Text for Simple Search API allows the creation of a manifest file that can be used to execute the NBIA Data Retriever. API example and return values for getManifestForSimpleSearch | The API takes the same arguments as the Simple Search GUI. |
Manifest Text | The Manifest Text API allows the creation of a manifest file that can be used to execute the NBIA Data Retriever. |
|
Manifest for Text Search | Generates a manifest file of series. This is an API version of the text search in the NBIA Radiology Portal GUI. See Performing a Text Search for more information. | textValue |
Manifest from Patient Study Series | A manifest file of patient IDs that match the input parameters API example and return values for getManifestfromPatientStudySeries |
|
MD5 Hierarchy | API example and return values for getMD5Hierarchy |
|
Manufacturer Values and Counts | The manufacturer and their counts API example and return values for getManufacturerValuesandCounts | Collection (R) |
MD5 Hash for Image | The API returns a zip file containing the DICOM images and a CSV file with the MD5 hash code for each image file. | sopInstanceUid |
Modality Values and Counts | The modality values plus the manufacturer count for the modality API example and return values for getModalityValuesandCounts |
|
Restrictions for Simple Search | API example and return values for getRestrictionsforSimpleSearch | |
Series Metadata 2 | The Series Metadata API allows returns the metadata needed by the client for a set of series as CSV. | list- Comma-separated list of series to return (R) |
Species Tax | API example and return values for getSpeciesTax | N/A |
Species Values And Counts | API example and return values for getSpeciesValuesAndCounts | |
Study Drill Down With Series IDs | API example and return values for getStudyDrillDownWithSeriesIDs | list |
Thumbnail | API example and return values for getThumbnail | seriesUID objectUID |
Text Search | API example and return values for getTextSearch | textValue |
Return Values
If the value for an attribute is null in the specified collection, it will not appear in the returned values.
Table of Content Zone | ||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||
Body Part Values and CountsExample Body Part Values and Countsservices/getBodyPartValuesAndCounts?Modality=PT"Sample Results The API returns the body parts and their counts.
Cart DataThis API takes a saved cart name (the parameter for this is "list"), which is part of the cart data URL after you put data into your cart and select Share My Cart in the NBIA Radiology Portal. For example, if your cart data URL were https://nbia.cancerimagingarchive.net/nbia-search/?saved-cart=nbia-55731690489493857, your saved cart name would be 55731690489493857. This API takes one parameter:
Example GetCartData Query
The API then returns all of the columns for the selected data.
Collection DescriptionsThis API takes a collection name and returns the collection's description. The API takes one parameter:
Example GetCollectionDescriptions Query
If successful, the API returns the collection description.
Code Block | | |||||||||||||||||||||||||
|
Code Block | ||
---|---|---|
| ||
curl -H "Authorization:Bearer eec67b9c-44fc-4fd8-809d-dea1b228c8b9YOUR_ACCESS_TOKEN" -k "https://imaging-qacmservices.ncicancerimagingarchive.nih.govnet/nbia-api/services/getCollectionOrSeriesForDOI" -d "DOI=https://doifor-CBIS-DDSM&CollectionOrSeries=collection" |
The API returns the collections with their counts.
Code Block | ||
---|---|---|
| ||
[\{"collection":"CBIS-DDSM","seriesInstanceUID":null,"thirdPartyAnanlysis":null}] |
Collection Site
The API returns all collections/sites in TCIA in JSON format.
The API does not take any parameters.
Example GetCollectionSite Query
Code Block | ||
---|---|---|
| ||
curl -H "Authorization:Bearer ACCESS_TOKEN" -k "https://services.cancerimagingarchive.net/nbia-api/services/getCollectionSite" |
Collection Values and Counts API
The Collection Values and Counts API returns the collections and the subject count for the collection.
getBodyPartValuesAndCounts?Modality=PT" |
Code Block | ||
---|---|---|
| ||
[
{"criteria":"ABDOMEN","count":"13"},
{"criteria":"CHEST","count":"298"},
{"criteria":"Chest","count":"1"},
{"criteria":"HEADNECK","count":"1"},{
"criteria":"Lung","count":"76"},
{"criteria":"THORAX_1_ROUTINE","count":"1"}
] |
Collection Descriptions
Example getCollectionDescriptions
Example Collection Values And CountsQuery
Code Block | ||
---|---|---|
| ||
curl -H "Authorization:Bearer 8159f96d-d2fc-4af9-aa83-9a29876ef758YOUR_ACCESS_TOKEN" -k “https"https://services.cancerimagingarchive.net/nbia-api/services/getCollectionValuesAndCounts" -d "criteriaType0=CollectionCriteria&value0=CBIS-DDSM" |
The API returns the collections with their counts.
getCollectionDescriptions?collectionName=4D-Lung" |
Code Block | ||
---|---|---|
| ||
[ {"criteriadescription":"IDRI","count":"614"}, {"criteria":"IDRICONDUIT","count":"66"}, {"criteria":"LIDC","count":"397"}, {"criteria":"RIDER Pilot","count":"130"}, {"criteria":"SportInjury","count":"1"} ] |
Create Saved Cart API
The Create Saved Cart API allows the creation of a saved cart.
The API takes four arguments:
- list - A repeatable parameter for each series you wish to have in the saved cart
- name- Name for the saved cart (note that names of saved carts must be unique)
- description - Description of the saved cart
- url - URL of the saved cart
Example Create Saved Cart Query
Code Block | ||
---|---|---|
| ||
curl -H "Authorization:Bearer 5e3d3b2a-2533-4257-ba76-aa498ab8d269" -k "https://services.cancerimagingarchive.net/nbia-api/services/createSharedList" -d "list=88.8.133841977708353813381069288155921822331&list=88.8.326983478845196402838719404831299211067&name=scottslist&description=mydescription&url=testurl" |
DICOM Metadata by Series UID API
The DICOM Metadata by Series UID API provides the functionality in the portal where the DICOM data is retrieved from a series.
The API takes one argument:
- SeriesUID
The SeriesUID is available from the Drill Down API call.
Example Metadata Query
Code Block | ||
---|---|---|
| ||
C:\curl>curl -H "Authorization:Bearer 25bbea7c-4b8d-4f64-9d95-6ad62313c7d6" -k "https://services.cancerimagingarchive.net/nbia-api/services/getDicomTags?SeriesUID=9999.266036705757333804188405684898037929022 |
The API sends back triples of all DICOM element, name, data in the file.
Code Block | ||
---|---|---|
| ||
[
{"element":"(0002,0001)","name":"File Meta Information Version","data":"00\\01"},
{"element":"(0002,0002)","name":"Media Storage SOP Class UID","data":"1.2.840.10008.5.1.4.1.1.2"}
................................... |
DICOM Tags By Image ID API
The DICOM Tag By Image ID API returns the DICOM tags and values associated with the image.
- imageID
The values used in this API can be derived by using the results of the imagePkId in the Drill Down to Images API.
Example DICOM Tags By Image ID Query
<p>\n\t<span>This data collection consists of images acquired during chemoradiotherapy of 20 locally-advanced, non-small cell lung cancer patients. The images include four-dimensional (4D) fan beam (4D-FBCT) and 4D cone beam CT (4D-CBCT). All patients underwent concurrent radiochemotherapy to a total dose of 64.8-70 Gy using daily 1.8 or 2 Gy fractions.</span></p>\n<p>\n\tA single Radiation Oncologist delineated targets and organs at risk in all 4D-FBCT and a limited number of 4D-CBCT images. All patients underwent concurrent radiochemotherapy to a total dose of 64.8-70 Gy using daily 1.8 or 2 Gy fractions.</p>\n<p>\n\tPlease see the <a href=\"http://doi.org/10.7937/K9/TCIA.2016.ELN8YGLE\" target=\"_blank\">4D-Lung</a> page to learn more about the images and to obtain any supporting metadata for this collection.</p>\n","id":236322816,"collectionDescTimestamp":1678942800000,"collectionName":"4D-Lung","userName":"tracyn","licenseId":null,"descriptionURI":"https://doi.org/10.7937/K9/TCIA.2016.ELN8YGLE"}] |
Collection or Series for DOI
Example getCollectionOrSeriesForDOI Query for Collection
Code Block | ||
---|---|---|
| ||
curl -H "Authorization:Bearer YOUR_ACCESS_TOKEN" -k "https://services.cancerimagingarchive.net/nbia-api/services/getCollectionOrSeriesForDOI" -d "DOI=https://doi.org/10.7937/K9/TCIA.2016.ELN8YGLE&CollectionOrSeries=collection" |
Return Value for Collection
Code Block | ||
---|---|---|
| ||
[{""collection"":""4D-Lung"",""seriesInstanceUID"":null,""thirdPartyAnanlysis"":null}] |
Example getCollectionOrSeriesForDOI Query for Series
Code Block | ||
---|---|---|
curl -H "Authorization:Bearer YOUR_ACCESS_TOKEN" -k "https: | ||
Code Block | ||
| ||
C:\curl>curl -H "Authorization:Bearer d9d01317-34c3-40ac-92dc-9a1287a159e4" -k "https://services.cancerimagingarchive.net/nbia-api/services/getDicomTagsByImageID?imageID=4587520" |
The API returns the tags and values.
Code Block | ||
---|---|---|
| ||
[{"element":"(0002,0001)","name":"File Meta Information Version","data":"00
01"},
{"element":"(0002,0002)","name":"Media Storage SOP Class UID","data":"1.2.840.10008.5.1.4.1.1.128"},
{"element":"(0002,0003)","name":"Media Storage SOP Instance UID","data":"88.8.263250895051952442807371950278727814872"},
{"element":"(0002,0010)... |
Drill Down API
The Drill Down API provides the functionality in the search client where the user drills down the studies and series associated with a given patient.
The API takes a list of series to query, using the parameter "list," that repeats for each series you want to retrieve. During the workflow these values come from the series identifiers in the Extended Simple Search with Modality and Body Part Paged Query.
Example Drill Down Query
Code Block | ||
---|---|---|
| ||
curl -H "Authorization:Bearer 946bddb4-d076-4fb1-8dff-81fb64d6f921" -k "https://services.cancerimagingarchive.net/nbia-api/services/getStudyDrillDown" -d "list=1376256&list=262144" |
The Drill Down API returns JSON with the information to populate the drill down to study screen. There can be multiple studies.
Code Block | ||
---|---|---|
| ||
[ {"studyId" : "88.8.40100432719994870453539459050137164864",
"date" : 671515200000,
"description" : "CT CHEST W/O CONTRAST",
"id" : 1310720,
"seriesList" : [ {
"seriesNumber" : "3",
"seriesUID" : "88.8.326983478845196402838719404831299211067",
"numberImages" : 9,
"modality" : "CT",
"manufacturer" : null,
"annotationsFlag" : false,
"annotationsSize" : 0,
"patientId" : "Project-3076386612",
"patientPkId" : "1277952",
"studyId" : "88.8.40100432719994870453539459050137164864",
"studyPkId" : 1310720,
"totalSizeForAllImagesInSeries" : 4739336,
"project" : "Project",
"description" : "LUNG",
"dataProvenanceSiteName" : null,
"manufacturerModelName" : null,
"softwareVersion" : null,
"maxFrameCount" : "0",
"seriesId" : "88.8.326983478845196402838719404831299211067",
"seriesPkId" : 1376256,
"exactSize" : 4739336 } ]} ] |
Drill Down Using Series UIDs API
The Drill Down Using Series UIDs API provides the functionality in the portal where the user drills down the studies and series associated with a set of IDs. In this case, the API takes Series Instance UIDs so the users can access this information outside of the Search Client workflow using any Series Instance UIDs that they are interested in.
The API simply takes a list of Series UIDs to query, using the parameter "list," that repeats for each Series UID you want to retrieve.
Example Drill Down Using Series UIDs Query
/getCollectionOrSeriesForDOI" -d "DOI=https://doi.org/10.7937/K9/TCIA.2016.ELN8YGLE&CollectionOrSeries=series" |
Return Value for Series
Code Block |
---|
[{""collection"":""4D-Lung"",""seriesInstanceUID"":""1.3.6.1.4.1.14519.5.2.1.6834.5010.100037757822547877540622085093"",""thirdPartyAnanlysis"":null},{""collection"":""4D-Lung"",""seriesInstanceUID"":""1.3.6.1.4.1.14519.5.2.1.6834.5010.100049789635984645130991826991"",""thirdPartyAnanlysis"":null},{""collection"":""4D-Lung"",""seriesInstanceUID"":""1.3.6.1.4.1.14519.5.2.1.6834.5010.100055011459662871005613719886"",""thirdPartyAnanlysis"":null},{""collection"":""4D-Lung"",""seriesInstanceUID"":""1.3.6.1.4.1.14519.5.2.1.6834.5010.100089621274100103247029607723"",""thirdPartyAnanlysis"":null},{""collection"":""4D-Lung"",""seriesInstanceUID"":""1.3.6.1.4.1.14519.5.2.1.6834.5010.100137773791956790807544371448"",""thirdPartyAnanlysis"":null},{""collection"":""4D-Lung"",""seriesInstanceUID"":""1.3.6.1.4.1.14519.5.2.1.6834.5010.100317870572035759487319851556"",""thirdPartyAnanlysis"":null},{""collection"":""4D-Lung"",""seriesInstanceUID"":""1.3.6.1.4.1.14519.5.2.1.6834.5010.100356687286872672203671297553"",""thirdPartyAnanlysis"":null},......." |
Collection Values and Counts
Example Collection Values And Counts Query
Code Block | ||
---|---|---|
| ||
curl -H "Authorization:Bearer YOUR_ACCESS_TOKEN" -k "https://services.cancerimagingarchive.net/nbia-api/services/getCollectionValuesAndCounts" |
Code Block | ||
---|---|---|
| ||
[
{"criteria":"IDRI","count":"614"},
{"criteria":"IDRICONDUIT","count":"66"},
{"criteria":"LIDC","count":"397"},
{"criteria":"RIDER Pilot","count":"130"},
{"criteria":"SportInjury","count":"1"}
] |
Create Saved Cart
Example Create Saved Cart Query
Code Block | ||
---|---|---|
| ||
curl -H "Authorization:Bearer YOUR_ACCESS_TOKEN" -k "https://services.cancerimagingarchive.net/nbia-api/services/createSharedList" -d "list=1.3.6.1.4.1.14519.5.2.1.6834.5010.100089621274100103247029607723&list=1.3.6.1.4.1.14519.5.2.1.6919.4624.113493579075669637574394466994&name=MyNewShareList&description=mysharelistdescription&url=https://myurl.com" |
NOTE: The "list" parameter must be repeated for each UID.
DICOM Metadata by Series UID
The SeriesUID is available from the Drill Down API call.
Example Metadata Query
Code Block | ||
---|---|---|
Code Block | ||
| ||
curl -H "Authorization:Bearer 5e3e2193-55dc-43b5-b11a-70fee2ccf50fYOUR_ACCESS_TOKEN" -k "https://services.cancerimagingarchive.net/nbia-api/services/getStudyDrillDownWithSeriesIds" -d "list=88.8.327219764444138790630242591550292040652&list=88.8.48940758713094405889891485363115655700"getDicomTags?SeriesUID=1.3.6.1.4.1.14519.5.2.1.6834.5010.100089621274100103247029607723" |
The API sends back triples of all DICOM element, name, data in the file.The Drill Down Using Series UIDs API returns JSON with the information to populate the drill down to study screen. You can retrieve multiple studies.
Code Block | ||
---|---|---|
| ||
[ {"studyIdelement" : "88.8.40100432719994870453539459050137164864", "date" : 671515200000, "description" : "CT CHEST W/O CONTRAST", "id" : 1310720, "seriesList" : [ { "seriesNumber" : "3", "seriesUID" : "88.8.326983478845196402838719404831299211067", "numberImages" : 9, "modality" : "CT", "manufacturer" : null, "annotationsFlag" : false, "annotationsSize" : 0, "patientId" : "Project-3076386612", "patientPkId" : "1277952", "studyId" : "88.8.40100432719994870453539459050137164864", "studyPkId" : 1310720, "totalSizeForAllImagesInSeries" : 4739336, "project" : "Project", "description" : "LUNG", "dataProvenanceSiteName" : null, "manufacturerModelName" : null, "softwareVersion" : null, "maxFrameCount" : "0", "seriesId" : "88.8.326983478845196402838719404831299211067", "seriesPkId" : 1376256, "exactSize" : 4739336 } ]} ] |
Drill Down to Images API
The Drill Down to Images API allows the developer to drill down to the images in a series and have the information available to create a WADO call that can retrieve the images themselves. This API is used to create the Thumbnails screen in the portal.
The API takes a list of series to query, using the parameter "list," that repeats for each series for which you want to retrieve images.
Example Drill Down to Images Query
Code Block | ||
---|---|---|
| ||
curl -H "Authorization:Bearer 946bddb4-d076-4fb1-8dff-81fb64d6f921" -k "https://services.cancerimagingarchive.net/nbia-api/services/getImageDrillDown" -d "list=1376256&list=262144" |
The API returns the information needed to populate the Thumbnails screen.
Code Block | ||
---|---|---|
| ||
[ { "imagePkId" : 1409028,
"contentDate" : null,
"contentTime" : null,
"seriesPkId" : 1376256,
"instanceNumber" : 73,
"sopInstanceUid" : "88.8.73811183841243046367164226375699603900",
"seriesInstanceUid" : "88.8.326983478845196402838719404831299211067",
"studyInstanceUid" : "88.8.40100432719994870453539459050137164864",
"size" : 526592,
"fileURI" : "C:\\projects\\NBIA\\nbia-install_6.3\\CTP-server\\CTP\\storage\\0000000000\\000\\000\\006.dcm",
"project" : null,
"siteName" : null,
"frameNum" : 0
}, {
"imagePkId" : 1409024,
"contentDate" : null,
"contentTime" : null,
"seriesPkId" : 1376256,
"instanceNumber" : 85,
8<------------------------------------------------------------------------------->8 |
The information needed to create a WADO call is the following snippet from this code:
Code Block | ||
---|---|---|
| ||
"sopInstanceUid" : "88.8.73811183841243046367164226375699603900",
"seriesInstanceUid" : "88.8.326983478845196402838719404831299211067",
"studyInstanceUid" : "88.8.40100432719994870453539459050137164864", |
Extended Simple Search with Modality and Body Part Paged API
The Extended Simple Search with Modality and Body Part Paged API is used to run queries for the Simple Search GUI in the NBIA client. This API uses a variety of criteria as seen in the NBIA client, as well as the pages of data the client requests. The available criteria types and their components follow. Since the simple search can take an unlimited number of criteria each of the criteria items is appended with a number signifying its order in the query, starting with 0.
- CollectionCriteria
- value
- ImageModalityCriteria
- value
- AnatomicalSiteCriteria
- value
- ManufacturerCriteria
- value
- DateRangeCriteria
- fromDate - Formatted "dd/mm/yyyy"
- toDate - Formatted "dd/mm/yyyy"
- PatientCriteria
- value
- MinNumberOfStudiesCriteria
- value
- SpeciesCriteria
- The code for the species
- PhantomCriteria
- yes for phantoms
- TimePointCriteria
- eventType the eventType for the timepoint
- fromDate - Formatted "dd/mm/yyyy"
- toDate - Formatted "dd/mm/yyyy"
- SortField
- The field to sort on
- SortDirection
- ascending or descending
- Start
- The page to start on
- Size
- How many items per page
Example Extended Simple Search with Modality and Body Part Paged Query
Code Block | ||
---|---|---|
| ||
curl -H "Authorization:Bearer d2310d88-cefe-491f-82a2-df66d6c087c4" -k "http://services.cancerimagingarchive.net/nbia-api/services/getSimpleSearchWithModalityAndBodyPartPaged" -d "criteriaType0=TimePointCriteria&eventType0=DIAGNOSIS&fromDay0=-5&toDay0=10&sortField=subject&sortDirection=descending&start=0&size=9" |
The API returns the results of the search.
Code Block | ||
---|---|---|
| ||
{
"resultSet":[
{
"subjectId":"Test-5910936489",
"project":"Test",
"id":819200,
"modalities":[
"CT"
],
"bodyParts":[
"LUNG"
],
"species":[
"L-877FC"
],
"timepoints":{
"DIAGNOSIS":[
1,
3
]
},
"totalNumberOfStudies":28,
"totalNumberOfSeries":61,
"studyIdentifiers":[
{
"seriesIdentifiers":[
917526,
917527,
917528
],
"seriesAndModality":[
],
"studyIdentifier":851979
},
{
"seriesIdentifiers":[
917529,
917530
],
"seriesAndModality":[
],
"studyIdentifier":851980
},
{
"seriesIdentifiers":[
917531,
917532
],
"seriesAndModality":[
],
"studyIdentifier":851981
}
]
}
],
"totalPatients":1,
"bodyParts":[
{
"value":"LUNG",
"count":1
}
],
"modalities":[
{
"value":"CT",
"count":1
}
],
"collections":[
{
"value":"Test",
"count":1
}
],
"species":[
{
"value":"L-877FC",
"count":1
}
],
"maxTimepoints":{
"DIAGNOSIS":3
},
"minTimepoints":{
"DIAGNOSIS":1
},
"sort":"subject-descending"
} |
Get Restrictions for Text Search
Code Block | ||
---|---|---|
| ||
curl -H "Authorization:Bearer 083c39d8-1316-4ec6-8bc9-7ae0163e2d0b" -X POST "http://services.cancerimagingarchive.net/nbia-api/services/getRestrictionsForTextSearch" -d "textValue=CT" |
Code Block | ||
---|---|---|
| ||
yes |
Image with MD5 Hash API
This API takes a series UID and returns a zip file with the images and a CSV file containing the MD5 hashes.
The API takes two arguments:
- Collection - The collection to update
- DOI - Digital Object Identifier
Example Image with MD5 Hash Query
Code Block | ||
---|---|---|
| ||
curl -H "Authorization:Bearer 72dfaea7-b704-4b31-ad90-02606faa4572" -k "http://services.cancerimagingarchive.net/nbia-api/services/v2/getImageWithMD5Hash?SeriesInstanceUID=1.3.6.1.4.1.14519.5.2.1.6919.4624.313514201353787659031503464798" |
The API returns the images and a CSV file in the zip file that records the file name and a hash.
Licenses API
The Licenses API retrieves all available license information.
The API takes no arguments.
Example Licenses Query
Code Block | ||
---|---|---|
| ||
curl -H "Authorization:Bearer ff849ffb-7b18-4c7e-83bd-6db2f7dbee9c" -k "https://services.cancerimagingarchive.net/nbia-api/services/getLicenses" |
If the API is successful, it returns the license long name, short name, license URL, license text, and commercial use designation.
Code Block | ||
---|---|---|
| ||
[
{
"longName":"Creative Commons Attribution 3.0 Unported License",
"id":1,
"shortName":"CC BY 3.0",
"licenseURL":"http://creativecommons.org/licenses/by/3.0/",
"licenseText":"https://creativecommons.org/licenses/by/3.0/",
"commercialUse":"YES",
"license":{
"id":1,
"longName":"Creative Commons Attribution 3.0 Unported License",
"shortName":"CC BY 3.0",
"url":"http://creativecommons.org/licenses/by/3.0/",
"commercialUse":"YES",
"licenseText":"https://creativecommons.org/licenses/by/3.0/"
}
},.... |
Manifest for Simple Search API
The Manifest Text for Simple Search API allows the creation of a manifest file that can be used to execute the NBIA Data Retriever.
The API takes the same arguments as the Simple Search GUI.
Example Manifest for Simple Search Query
Code Block | ||
---|---|---|
| ||
curl -H "Authorization:Bearer 73c7f5c1-8d3b-49a6-81fc-fdc40f31da68" -k "http://localhost:8080/nbia-api/services/getManifestForSimpleSearch" -d "criteriaType0=ThirdPartyAnalysis&value0=yes&sortField=subject&sortDirection=descending&start=0&size=1000000" |
The API returns text that can be used as a manifest file for the NBIA Data Retriever.
Code Block | ||
---|---|---|
| ||
downloadServerUrl=https://imaging-devcm.nci.nih.gov/nbia-download/servlet/DownloadServlet
includeAnnotation=false
noOfrRetry=4
databasketId=manifest-1523866570303.tcia
manifestVersion=3.0
ListOfSeriesToDownload=
1.3.6.1.4.1.9328.50.3.336 |
Manifest Text API
The Manifest Text API allows the creation of a manifest file that can be used to execute the NBIA Data Retriever.
The API takes two arguments:
- list - A repeatable parameter of series UIDs for each series you want to download
- includeAnnotation - If "true" is used, the annotations are returned.
Example Manifest Query
Code Block | ||
---|---|---|
| ||
curl -H "Authorization:Bearer d98c390f-b53d-4456-beb3-110e63663762" -k "https://services.cancerimagingarchive.net/nbia-api/services/getManifestTextV2" -d "list=1.3.6.1.4.1.9328.50.3.336&includeAnnotation=false" |
The API returns text that can be used as a manifest file for the NBIA Data Retriever.
Code Block | ||
---|---|---|
| ||
downloadServerUrl=https://imaging-devcm.nci.nih.gov/nbia-download/servlet/DownloadServlet
includeAnnotation=false
noOfrRetry=4
databasketId=manifest-1523866570303.tcia
manifestVersion=3.0
ListOfSeriesToDownload=
1.3.6.1.4.1.9328.50.3.336 |
Manifest for Collection
This API takes the collection name and optional parameters and generates a manifest file. The manifest file name includes the collection name and the date and time the file is generated.
If the visibility status is not given, the manifest will include only visible series of the specified collection.
Multiple visibility statuses can be given but each visibility status needs to be separated by "," which means all series with visibility in the given parameters.
The API takes the following parameters:
- collectionName (required)
- Visibility (optional)
includeAnnotation (optional)
Example getManifestforCollection Query
Code Block | ||
---|---|---|
| ||
curl -X POST -d "collection=LIDC-IDRI&visibility=1,2,5" -H "Authorization:Bearer 116f33a0-3ec6-4537-ac4f-b2a8f804198e" -k "https://services.cancerimagingarchive.net/nbia-api/services/getManifestForCollection" |
Code Block | ||
---|---|---|
| ||
downloadServerUrl=https://services.cancerimagingarchive.net/nbia-download/servlet/DownloadServlet
includeAnnotation=true
noOfrRetry=4
databasketId=2023-03-29_13-07.tcia
manifestVersion=3.0
ListOfSeriesToDownload=
139.254584023992084271703954671177780104476
139.284188174537413748743284550513035752067
139.304805639045342787376284410986944361990
140.214500419403769671714337260708113154277
140.238309468517260042204179442848160894322
140.254584023992084271703954671177780104476
140.284188174537413748743284550513035752067
140.304805639045342787376284410986944361990
141.129839648603007453048077880391250668065
141.284188174537413748743284550513035752067
142.175160332554951146990169356698524556465
142.185789358393722251565123042321429001230
142.249217400295704932720804776925858673102
142.266852653429423697948518302395106991468
142.284188174537413748743284550513035752067
143.185789358393722251565123042321429001230
143.284188174537413748743284550513035752067
143.304805639045342787376284410986944361990
143.83777781977605049394256836747163797173 |
Get Manifest for Text Search
This API takes a text value and generates a manifest file of series. This is an API version of the text search in the NBIA Radiology Portal GUI. See Performing a Text Search for more information.
This API takes the following parameter:
- textValue
Example getManifestForTextSearch Query
Code Block | ||
---|---|---|
| ||
curl -H "Authorization:Bearer 41489cab-cd3b-4130-8215-7f4f9a6f12bb" -X POST "http://services.cancerimagingarchive.net/nbia-api/services/getManifestForTextSearch" -d "textValue=CT" |
Code Block | ||
---|---|---|
| ||
downloadServerUrl=http://services.cancerimagingarchive.net/nbia-download/servlet/DownloadServlet
includeAnnotation=false
noOfrRetry=4
databasketId=manifest-1680987888150.tcia
manifestVersion=3.0
ListOfSeriesToDownload=
1.3.6.1.4.1.9328.50.4.563784
1.3.6.1.4.1.9328.50.4.568673
1.3.6.1.4.1.9328.50.4.568676
1.3.6.1.4.1.9328.50.4.568678
1.3.6.1.4.1.9328.50.4.569267
1.3.6.1.4.1.9328.50.4.569270
1.3.6.1.4.1.9328.50.4.569273
1.3.6.1.4.1.9328.50.4.569823
1.3.6.1.4.1.9328.50.4.571319
1.3.6.1.4.1.9328.50.4.571323
1.3.6.1.4.1.9328.50.4.571803
1.3.6.1.4.1.9328.50.4.571808
1.3.6.1.4.1.9328.50.4.572414
1.3.6.1.4.1.9328.50.4.572418
1.3.6.1.4.1.9328.50.4.572422
1.3.6.1.4.1.9328.50.4.572425
1.3.6.1.4.1.9328.50.4.572983
1.3.6.1.4.1.9328.50.4.573038
1.3.6.1.4.1.9328.50.4.573635
1.3.6.1.4.1.9328.50.4.573639
1.3.6.1.4.1.9328.50.4.574149
1.3.6.1.4.1.9328.50.4.574153
1.3.6.1.4.1.9328.50.4.578325
1.3.6.1.4.1.9328.50.4.578328
1.3.6.1.4.1.9328.50.4.578331
1.3.6.1.4.1.9328.50.4.578901
1.3.6.1.4.1.9328.50.4.579479
1.3.6.1.4.1.9328.50.4.579482
1.3.6.1.4.1.9328.50.4.579494
1.3.6.1.4.1.9328.50.4.580056
1.3.6.1.4.1.9328.50.4.579487
1.3.6.1.4.1.9328.50.4.579490
1.3.6.1.4.1.9328.50.4.580594
1.3.6.1.4.1.9328.50.4.581140
1.3.6.1.4.1.9328.50.4.590291
1.3.6.1.4.1.9328.50.4.590294
1.3.6.1.4.1.9328.50.4.590297
1.3.6.1.4.1.9328.50.4.590890
1.3.6.1.4.1.9328.50.4.591508
1.3.6.1.4.1.9328.50.4.591511
1.3.6.1.4.1.9328.50.4.591513
1.3.6.1.4.1.9328.50.4.591516
1.3.6.1.4.1.9328.50.4.591522
1.3.6.1.4.1.9328.50.4.591975
1.3.6.1.4.1.9328.50.4.592513
1.3.6.1.4.1.9328.50.4.593093
1.3.6.1.4.1.9328.50.4.593096
1.3.6.1.4.1.9328.50.4.593099
1.3.6.1.4.1.9328.50.4.593601
1.3.6.1.4.1.9328.50.4.594099
1.3.6.1.4.1.9328.50.4.594613
1.3.6.1.4.1.9328.50.4.595110
1.3.6.1.4.1.9328.50.4.595623
1.3.6.1.4.1.9328.50.4.596197
1.3.6.1.4.1.9328.50.4.596737
1.3.6.1.4.1.9328.50.4.600540
1.3.6.1.4.1.9328.50.4.600543
1.3.6.1.4.1.9328.50.4.601079
1.3.6.1.4.1.9328.50.4.601082
1.3.6.1.4.1.9328.50.4.601085
1.3.6.1.4.1.9328.50.4.601643
1.3.6.1.4.1.9328.50.4.604326
1.3.6.1.4.1.9328.50.4.604330
1.3.6.1.4.1.9328.50.4.604333
1.3.6.1.4.1.9328.50.4.604801
1.3.6.1.4.1.9328.50.4.604806
1.3.6.1.4.1.9328.50.4.607091
1.3.6.1.4.1.9328.50.4.607094
1.3.6.1.4.1.9328.50.4.607097
1.3.6.1.4.1.9328.50.4.618649
1.3.6.1.4.1.9328.50.4.610796
1.3.6.1.4.1.9328.50.4.610799
1.3.6.1.4.1.9328.50.4.610803
1.3.6.1.4.1.9328.50.4.611364
1.3.6.1.4.1.9328.50.4.611919
1.3.6.1.4.1.9328.50.4.612031
1.3.6.1.4.1.9328.50.4.612039
1.3.6.1.4.1.9328.50.4.612593
1.3.6.1.4.1.9328.50.4.612598
1.3.6.1.4.1.9328.50.4.613155
1.3.6.1.4.1.9328.50.4.613159
1.3.6.1.4.1.9328.50.4.613786
1.3.6.1.4.1.9328.50.4.613791
1.3.6.1.4.1.9328.50.4.613794
1.3.6.1.4.1.9328.50.4.614396
1.3.6.1.4.1.9328.50.4.614399 |
Manifest from Patient Study Series
This API takes a a parameter and generates a manifest file of patient IDs that match those parameters.
This API takes the following parameters:
- patientIDs
- studyUIDs
- seriesUIDs
- anyOrAll
- includeAnnotation
"(0027,1047)","name":"","data":"1.0"},{"element":"(0027,1050)","name":"","data":"0.0"},{"element":"(0027,1051)","name":"","data":"0.0"},{"element":"(0028,0002)","name":"Samples per Pixel","data":"1"},{"element":"(0028,0004)","name":"Photometric Interpretation","data":"MONOCHROME2"},{"element":"(0028,0010)","name":"Rows","data":"512"},{"element":"(0028,0011)","name":"Columns","data":"512"},{"element":"(0028,0030)","name":"Pixel Spacing","data":"0.878906\\0.878906"},{"element":"(0028,0100)","name":"Bits Allocated","data":"16"},{"element":"(0028,0101)","name":"Bits Stored","data":"16"},{"element":"(0028,0102)","name":"High Bit","data":"15"},{"element":"(0028,0103)","name":"Pixel Representation","data":"1"},{"element":"(0028,0120)","name":"Pixel Padding Value","data":"-2000"},{"element":"(0028,0303)","name":"Longitudinal Temporal Information Modified","data":"MODIFIED"},{"element":"(0028,1050)","name":"Window Center","data":"40"},{"element":"(0028,1051)","name":"Window Width","data":"400"},{"element":"(0028,1052)","name":"Rescale Intercept","data":"0"},{"element":"(0028,1053)","name":"Rescale Slope","data":"1"},{"element":"(0028,1054)","name":"Rescale Type","data":"HU"},{"element":"(0040,0244)","name":"Performed Procedure Step Start Date","data":"19950522"},{"element":"(0040,0245)","name":"Performed Procedure Step Start Time","data":"161702"},{"element":"(0040,0254)","name":"Performed Procedure Step Description","data":"4dct stereo"},{"element":"(0043,0010)","name":"","data":"GEMS_PARM_01"},{"element":"(0043,1010)","name":"","data":"400"},{"element":"(0043,1012)","name":"","data":"99\\99\\99"},{"element":"(0043,1016)","name":"","data":"0"},{"element":"(0043,101E)","name":"","data":"0.000000"},{"element":"(0043,101F)","name":"","data":"0"},{"element":"(0043,1021)","name":"","data":"0"},{"element":"(0043,1025)","name":"","data":"0\\0\\0\\0\\0\\0"},{"element":"(0043,1026)","name":"","data":"0\\0\\0\\0\\0\\0\\0\\0"},{"element":"(0043,1027)","name":"","data":""},{"element":"(0043,102B)","name":"","data":"2\\0\\0\\0"},{"element":"(0043,1031)","name":"","data":"0.000000\\0.000000"},{"element":"(0043,1040)","name":"","data":"353.85443"},{"element":"(0043,1041)","name":"","data":"3600.8787"},{"element":"(0043,1042)","name":"","data":"0"},{"element":"(0043,1043)","name":"","data":"0"},{"element":"(0043,1044)","name":"","data":"0"},{"element":"(0043,1045)","name":"","data":"0"},{"element":"(0043,1046)","name":"","data":"0"},{"element":"(0043,104D)","name":"","data":"0.0"},{"element":"(0043,104E)","name":"","data":"5.00122"},{"element":"(0045,0010)","name":"","data":"GEMS_HELIOS_01"},{"element":"(0045,1001)","name":"","data":"8"},{"element":"(0045,1002)","name":"","data":"2.5"},{"element":"(0045,1003)","name":"","data":"7"},{"element":"(0045,1004)","name":"","data":"6"},{"element":"(0045,1006)","name":"","data":"INTO GANTRY"},{"element":"(0045,1007)","name":"","data":"0.0"},{"element":"(0045,1008)","name":"","data":"0"},{"element":"(0045,1009)","name":"","data":"17"},{"element":"(0045,100A)","name":"","data":"0.0"},{"element":"(0045,100B)","name":"","data":"0.0"},{"element":"(0045,100C)","name":"","data":"0"},{"element":"(0045,100D)","name":"","data":"0"},{"element":"(0045,100E)","name":"","data":"0.0"},{"element":"(0045,100F)","name":"","data":"0.0"},{"element":"(0045,1010)","name":"","data":"0"},{"element":"(0045,1011)","name":"","data":"0"},{"element":"(0045,1012)","name":"","data":"0"},{"element":"(0045,1013)","name":"","data":"10"},{"element":"(0045,1014)","name":"","data":"0"},{"element":"(0045,1015)","name":"","data":"0"},{"element":"(0045,1016)","name":"","data":"0"},{"element":"(0045,1017)","name":"","data":"0"},{"element":"(0045,1018)","name":"","data":"0"},{"element":"(0045,1021)","name":"","data":"0"},{"element":"(0045,1022)","name":"","data":"0"},{"element":"(0045,1032)","name":"","data":"0.5"}] |
Extended Simple Search with Modality and Body Part Paged
The Extended Simple Search with Modality and Body Part Paged API is used to run queries for the Simple Search GUI in the NBIA client. This API uses a variety of criteria as seen in the NBIA client, as well as the pages of data the client requests. The available criteria types and their components follow. Since the simple search can take an unlimited number of criteria, each of the criteria items is appended with a number signifying its order in the query, starting with 0.
Example Extended Simple Search with Modality and Body Part Paged Query
Code Block | ||
---|---|---|
| ||
curl -H "Authorization:Bearer YOUR_ACCESS_TOKEN" -k "https://services.cancerimagingarchive.net/nbia-api/services/getSimpleSearchWithModalityAndBodyPartPaged" -d "criteriaType0=TimePointCriteria&eventType0=DIAGNOSIS&fromDay0=-5&toDay0=10&sortField=subject&sortDirection=descending&start=0&size=9" |
The API returns the results of the search.
Code Block | ||
---|---|---|
| ||
{
"resultSet":[
{
"subjectId":"Test-5910936489",
"project":"Test",
"id":819200,
"modalities":[
"CT"
],
"bodyParts":[
"LUNG"
],
"species":[
"L-877FC"
],
"timepoints":{
"DIAGNOSIS":[
1,
3
]
},
"totalNumberOfStudies":28,
"totalNumberOfSeries":61,
"studyIdentifiers":[
{
"seriesIdentifiers":[
917526,
917527,
917528
],
"seriesAndModality":[
],
"studyIdentifier":851979
},
{
"seriesIdentifiers":[
917529,
917530
],
"seriesAndModality":[
],
"studyIdentifier":851980
},
{
"seriesIdentifiers":[
917531,
917532
],
"seriesAndModality":[
],
"studyIdentifier":851981
}
]
}
],
"totalPatients":1,
"bodyParts":[
{
"value":"LUNG",
"count":1
}
],
"modalities":[
{
"value":"CT",
"count":1
}
],
"collections":[
{
"value":"Test",
"count":1
}
],
"species":[
{
"value":"L-877FC",
"count":1
}
],
"maxTimepoints":{
"DIAGNOSIS":3
},
"minTimepoints":{
"DIAGNOSIS":1
},
"sort":"subject-descending"
} |
Image with MD5 Hash
Example Image with MD5 Hash
Example getManifestFromPatientStudySeriesQuery
Code Block | ||
---|---|---|
| ||
curl -H "Authorization:Bearer YOUR_ACCESS_TOKEN” -k "https://public.cancerimagingarchive.net/nbia-api/services/v2/getImageWithMD5Hash?SeriesInstanceUID=1.3.6.1.4.1.14519.5.2.1.6834.5010.100089621274100103247029607723" |
Manifest for Simple Search
Example Manifest for Simple Search Query
Code Block | ||
---|---|---|
| ||
curl -H "Authorization:Bearer YOUR_ACCESS_TOKEN116f33a0-3ec6-4537-ac4f-b2a8f804198e" -k "httphttps://services.cancerimagingarchive.net/nbia-api/services/getManifestFromPatientStudySeriesgetManifestForSimpleSearch" -d "patientIDs=ISPY1_1001" |
If successful, the API returns the following.
criteriaType0=ThirdPartyAnalysis&value0=yes&sortField=subject&sortDirection=descending&start=0&size=100" |
Code Block | ||
---|---|---|
| ||
downloadServerUrl=httphttps://servicesnbia.cancerimagingarchive.net/nbia-download/servlet/DownloadServlet includeAnnotation=truefalse noOfrRetry=4 databasketId=manifest-16801117793661693254833353.tcia manifestVersion=3.0 ListOfSeriesToDownload= 1.3.6.1.4.1.145195962.1.51.20.10.76951548529146.170050549.2509552432957738326266175494821264 1.3.6.1.4.1.145195962.1.51.20.10.76951548529146.170050549.3603893607424276675260706558431263 1.3.6.1.4.1.145195962.5.2.1.7695.1700.334491271566855314830260417024 1.30.60.11548529146.4.1.14519.5.2.1.7695.1700.65844126267128730945734630570550549.1261 1.3.6.1.4.1.145195962.5.2.1.7695.1700.131126392922209124942161386151 1.30.60.11548529146.4.1.14519.5.2.1.7695.1700.93331619574612015590333974010350549.1265 1.3.6.1.4.1.14519.55962.2.1.7695.1700.274616783627161175251743615553 1.30.60.11548529146.4.1.14519.5.2.1.7695.1700.733313000644315272006192181431 1.50549.1262 |
Manifest Text
Example Manifest Query
Code Block |
---|
curl -H "Authorization:Bearer YOUR_ACCESS_TOKEN" -k "https://services.cancerimagingarchive.net/nbia-api/services/getManifestTextV2" -d "list=1.3.6.1.4.1.14519.5.2.1.6834.5010.100089621274100103247029607723&includeAnnotation=false" |
Code Block | ||
---|---|---|
| ||
"downloadServerUrl=https://nbia.cancerimagingarchive.net/nbia-download/servlet/DownloadServlet includeAnnotation=false noOfrRetry=4 databasketId=manifest-1692722233257.tcia manifestVersion=3.0 ListOfSeriesToDownload=.7695.1700.220092773361369396087067751186 1.3.6.1.4.1.14519.5.2.1.76956834.5010.100089621274100103247029607723" |
Manifest for Text Search
This API takes a text value and generates a manifest file of series. This is an API version of the text search in the NBIA Radiology Portal GUI. See Performing a Text Search for more information.
Example getManifestForTextSearch Query
Code Block | ||
---|---|---|
| ||
curl -H "Authorization:Bearer YOUR_ACCESS_TOKEN" -X POST "https://services.cancerimagingarchive.net/nbia-api/services/GetManifestForTextSearch" -d "textValue=CT" |
Code Block | ||
---|---|---|
| ||
downloadServerUrl=https://services.cancerimagingarchive.net/nbia-download/servlet/DownloadServlet includeAnnotation=false noOfrRetry=4 databasketId=manifest-1680987888150.tcia manifestVersion=3.0 ListOfSeriesToDownload=1700.245270018412514241929134140425 1.3.6.1.4.1.14519.5.2.1.7695.1700.229054711046553504545787083659 1.3.6.1.4.1.14519.5.2.1.7695.1700.179162285704690412763684330250 1.3.6.1.4.1.145199328.550.2.1.7695.1700.2348085604186292090177849580534.563784 1.3.6.1.4.1.145199328.550.2.1.7695.1700.1546165565556864988173413374784.568673 1.3.6.1.4.1.145199328.550.2.1.7695.1700.1776237572501319702648570921914.568676 1.3.6.1.4.1.145199328.550.2.1.7695.1700.1541108252443698851718515512554.568678 1.3.6.1.4.1.145199328.550.2.1.7695.1700.2845673513044263762267907142644.569267 1.3.6.1.4.1.145199328.550.2.1.7695.1700.324328467511449053797650611970 1.3.64.569270 |
Manifest from Patient Study Series
This API takes a a parameter and generates a manifest file of patient IDs that match those parameters.
This API takes the following parameters:
- patientIDs (required)
- studyUIDs (optional)
- seriesUIDs (optional)
- anyOrAll (optional)
- includeAnnotation (optional)
Example getManifestFromPatientStudySeries Query
Code Block | ||
---|---|---|
| ||
curl -H "Authorization:Bearer YOUR_ACCESS_TOKEN>" -k "https://services.cancerimagingarchive.net/nbia-api/services/getManifestFromPatientStudySeries" -d "patientIDs=ISPY1_1001" |
If successful, the API returns the following.
Code Block | ||
---|---|---|
| ||
downloadServerUrl=https://nbia.cancerimagingarchive.net/nbia-download/servlet/DownloadServlet includeAnnotation=true noOfrRetry=4 databasketId=manifest-1692722426170.tcia manifestVersion=3.0 ListOfSeriesToDownload= 1.3.6.1.4.1.14519.5.2.1.7695.1700.250955243295773832626617549482 1.3.6.1.4.1..1.4.1.14519.5.2.1.7695.1700.741335780571671051586458569948360389360742427667526070655843 1.3.6.1.4.1.14519.5.2.1.7695.1700.335719452327097001305227418372334491271566855314830260417024 1.3.6.1.4.1.14519.5.2.1.7695.1700.210538707954985296677398591978658441262671287309457346305705 1.3.6.1.4.1.14519.5.2.1.7695.1700.195983148423034180376334647727 1.3.6.1.4.1.14519.5.2.1.7695.1700.244863941836141483641489109194 |
MD5 Hierarchy
This API takes the following parameters:
- SeriesInstanceUID (optional)
- StudyInstanceUID (optional)
- PatientID (optional)
- Collection (optional)
Example getMD5Hierarchy Query
Code Block | ||
---|---|---|
| ||
curl -H "Authorization:Bearer 6cee6e71-7ade-4351-806d-f43d6301834a" -k "http://services.cancerimagingarchive.net/nbia-api/services/getMD5Hierarchy" -d "Collection=LIDC" |
Code Block | ||
---|---|---|
| ||
3ef5cbc40b247c4a6f72a4f90f504ad1 |
Manufacturer Values and Counts API
The Manufacturer Values and Counts API returns the modality values plus the manufacturer count for the modality. It optionally takes the following parameters.
- Collection
- Modality
- Body Part Examined
Example getManufacturerValuesAndCounts Query
Code Block | ||
---|---|---|
| ||
curl -H "Authorization:Bearer c428d42c-9eed-4f5d-8007-416d46be9b52" -k "https://services.cancerimagingarchive.net/nbia-api/services/getManufacturerValuesAndCounts?Modality=PT" |
The API returns the manufacturer and their counts.
Code Block | ||
---|---|---|
| ||
[
{"criteria":"DeJarnette Research Systems","count":"2"},
{"criteria":"FUJI PHOTO FILM Co., ltd.","count":"4"}
] |
Manufacturer Tree API
The Manufacturer Tree API returns the manufacturer and software in a tree structure.
Example getManufacturerTree Query
Code Block | ||
---|---|---|
| ||
curl -H "Authorization:Bearer 3ecccd7d-9d72-4424-bd81-757d79cd44aa" -k "https://services.cancerimagingarchive.net/nbia-api/services/getManufacturerTree" |
The API returns the data in a tree structure.
Code Block | ||
---|---|---|
| ||
{"data":{"criteria":"root","value":"All Manufactures"},
"children":[{"data":{"criteria":"Manufacturer","value":"CMS, Inc."},
"children":[{"data":{"criteria":"Model","value":"XiO"},
"children":[{"data":{"criteria":"Software Ver.","value":"4.51.00"},
"children":[]},{"data":{"criteria":"Software Ver.","value":"4.51.02"},"children":[]}]}]},
{"data":{"criteria":"Manufacturer","value":"CPS"},
"children":[{"data":{"criteria":"Model","value":"1024"}
8<------------------------------------------------------------------------------->8 |
MD5 Hash for Image API
This API takes the SOPInstanceIUD and returns an MD5 hash.
The API takes one argument:
- sopInstanceUid - UID of the image
Example MD5 Hash for Image Query
Code Block | ||
---|---|---|
| ||
curl -H "Authorization:Bearer 295382ae-e94c-473c-a98e-db10ce6ad774" -k "http://services.cancerimagingarchive.net/nbia-api/services/v2/getM5HashForImage?SOPInstanceUid=1.3.6.1.4.1.14519.5.2.1.6919.4624.302693755253199226108824913410" |
The API returns the MD5 hash.
MinMax Timepoints
Example getMinMaxTimepoints Query
Code Block | ||
---|---|---|
| ||
curl -H "Authorization:Bearer ffcf98b9-ab8f-4c3a-92bd-873e3f231de9" -k "http://services.cancerimagingarchive.net/nbia-api/services/getMinMaxTimepoints" |
Code Block | ||
---|---|---|
| ||
{"maxTimepoints":{"DIAGNOSIS":-1},"minTimepoints":{"DIAGNOSIS":-32871}} |
Modality Values and Counts API
The Modality Values and Counts API returns the modality values plus the subject count for the modality. It optionally takes the following parameters.
- Collection
- BodyPartExamined
Example Modality Values and Counts Query
Code Block | ||
---|---|---|
| ||
curl -H "Authorization:Bearer c428d42c-9eed-4f5d-8007-416d46be9b52" -k "https://services.cancerimagingarchive.net/nbia-api/services/getModalityValuesAndCounts?Collection=LIDC" |
The API returns the modalities and their counts.
Code Block | ||
---|---|---|
| ||
[
{"criteria":"CT","count":"397"}
] |
Restrictions for Simple Search API
The Restrictions on Simple Search API returns whether any series returned by simple search has commercial restrictions.
The API takes the same parameters as the Simple Search GUI.
Example getRestrictionsForSimpleSearch Query
Code Block | ||
---|---|---|
| ||
curl -H "Authorization:Bearer 1fb4f3b5-f30e-4ccf-bea9-8b51183a70cd" -k "http://localhost:8080/nbia-api/services/getRestrictionsForSimpleSearch" -d "criteriaType0=ThirdPartyAnalysis&value0=yes&sortField=subject&sortDirection=descending&start=0&size=1000000" |
The API returns "Yes" if there are commercial restrictions and "No" if there are not.
Series Metadata API
The Series Metadata API allows returns the metadata needed by the client for a set of series as CSV.
The API takes one argument:
- list- Comma-separated list of series to return
Example Series Metadata Query
Code Block | ||
---|---|---|
| ||
curl -H "Authorization:Bearer 1be042c4-2506-4ecc-9c5e-9556506896aa" -k "https://services.cancerimagingarchive.net/nbia-api/services/getSeriesMetadata2" -d "list=9999.293545899757968087866143572947417050996,9999.172212451609088872857235914630319746611" |
The API returns ok if successful, and the error if one occurs.
Code Block | ||
---|---|---|
| ||
Subject ID,Study UID,Study Description,Study Date,Series ID,Series Description,Number of images,File Size (Bytes),Collection Name,Modality,Manufacturer,3rd Party Analysis,Data Description URI,Series Number,License Name,License URL
STS_010,1.3.6.1.4.1.14519.5.2.1.5168.1900.154535988064062152660648619556,MRI LT LEG +C,2003-12-12,1.3.6.1.4.1.14519.5.2.1.5168.1900.104193299251798317056218297018,2. AXIAL T1 BOTH LEGS - RESEARCH,48,25273786,Soft-tissue-Sarcoma,MR,GE MEDICAL SYSTEMS,,https://doi.org/10.7937/K9/TCIA.2015.7GO2GSKS,2,Creative Commons Attribution 3.0 Unported License,http://creativecommons.org/licenses/by/3.0/ |
Species Tax API
The Species Tax API returns the species taxonomy and takes no parameters.
Example Species Tax Query
Code Block | ||
---|---|---|
| ||
C:\curl>curl -H "Authorization:Bearer 0a6c0a95-1919-4430-888d-5375fca7566f" -k "https://services.cancerimagingarchive.net/nbia-api/services/getSpeciesTax" |
The API returns the current species taxonomy.
Code Block | ||
---|---|---|
| ||
[\{"speciesCode":"L-877FC","speciesDescription":"Rattus norvegicus (common rat)"},\{"speciesCode":"L-85003","speciesDescription":"Human (Homo sapiens)"}] |
Species Values And Counts API
The Get Species Values And Counts API returns the values and counts for species and takes the same parameters as the Simple Search GUI.
Example Species Values And Counts Query
Code Block | ||
---|---|---|
| ||
C:\curl>curl -H "Authorization:Bearer 9227f2ee-5936-4fe9-8268-131e50833527" -k "https://services.cancerimagingarchive.net/nbia-api/services/getSimpleSearchCriteriaValues" -d "criteriaType0=CollectionCriteria&value0=CBIS-DDSM" |
The API returns the values and counts for species.
Code Block | ||
---|---|---|
| ||
[{"criteria":"Collections","values":[
{"criteria":"CBIS-DDSM","count":"80"}
]},
{"criteria":"Species","values":[\{"criteria":"Human","count":"80"}
]},
{"criteria":"Image Modality","values":[\{"criteria":"MG","count":"80"}
]},
{"criteria":"Anatomical Site","values":[\{"criteria":"BREAST","count":"80"}
]},
{"criteria":"Manufacturer","values":[\{"criteria":"","count":"80"}
]}] |
Study Drill Down API
The Study Drill Down API provides the functionality in the portal where the user drills down the studies and series associated with a given user.
The API simply takes a list of series to query, using the parameter "list", that is repeated for each series you want to retrieve.
Example Study Drill Down Query
Code Block | ||
---|---|---|
| ||
curl -H "Authorization:Bearer 946bddb4-d076-4fb1-8dff-81fb64d6f921" -k "https://services.cancerimagingarchive.net/nbia-api/services/getStudyDrillDown" -d "list=1376256&list=262144" |
The Study Drill Down API returns JSON with the information to populate the drill down to study screen. You can retrieve multiple studies.
Code Block | ||
---|---|---|
| ||
[ {"studyId" : "88.8.40100432719994870453539459050137164864",
"date" : 671515200000,
"description" : "CT CHEST W/O CONTRAST",
"id" : 1310720,
"seriesList" : [ {
"seriesNumber" : "3",
"seriesUID" : "88.8.326983478845196402838719404831299211067",
"numberImages" : 9,
"modality" : "CT",
"manufacturer" : null,
"annotationsFlag" : false,
"annotationsSize" : 0,
"patientId" : "Project-3076386612",
"patientPkId" : "1277952",
"studyId" : "88.8.40100432719994870453539459050137164864",
"studyPkId" : 1310720,
"totalSizeForAllImagesInSeries" : 4739336,
"project" : "Project",
"description" : "LUNG",
"dataProvenanceSiteName" : null,
"manufacturerModelName" : null,
"softwareVersion" : null,
"maxFrameCount" : "0",
"seriesId" : "88.8.326983478845196402838719404831299211067",
"seriesPkId" : 1376256,
"exactSize" : 4739336 } ]} ] |
Study Drill Down With Series IDs API
The Study Drill Down API provides the functionality in the portal where the user drills down to the studies and series associated with a given user.
The API takes a list of series to query, using the parameter "list," that is repeated for each series instance UIDs you want to retrieve.
Example Study Drill Down With Series IDs Query
Code Block | ||
---|---|---|
| ||
curl -H "Authorization:Bearer 5e3e2193-55dc-43b5-b11a-70fee2ccf50f" -k "https://services.cancerimagingarchive.net/nbia-api/services/getStudyDrillDownWithSeriesIds" -d "list=88.8.327219764444138790630242591550292040652&list=88.8.48940758713094405889891485363115655700" |
The Study Drill Down With Series Ids API returns JSON with the information to populate the drill down to study screen. There can be multiple studies.
Code Block | ||
---|---|---|
| ||
[ {"studyId" : "88.8.40100432719994870453539459050137164864",
"date" : 671515200000,
"description" : "CT CHEST W/O CONTRAST",
"id" : 1310720,
"seriesList" : [ {
"seriesNumber" : "3",
"seriesUID" : "88.8.326983478845196402838719404831299211067",
"numberImages" : 9,
"modality" : "CT",
"manufacturer" : null,
"annotationsFlag" : false,
"annotationsSize" : 0,
"patientId" : "Project-3076386612",
"patientPkId" : "1277952",
"studyId" : "88.8.40100432719994870453539459050137164864",
"studyPkId" : 1310720,
"totalSizeForAllImagesInSeries" : 4739336,
"project" : "Project",
"description" : "LUNG",
"dataProvenanceSiteName" : null,
"manufacturerModelName" : null,
"softwareVersion" : null,
"maxFrameCount" : "0",
"seriesId" : "88.8.326983478845196402838719404831299211067",
"seriesPkId" : 1376256,
"exactSize" : 4739336 } ]} ] |
Thumbnail API
The Get Thumbnail API returns the DICOM tags and values associated with the image.
- seriesUID
- objectUID
Example Thumbnail Query
Code Block | ||
---|---|---|
| ||
curl -H "Authorization:Bearer f314f9bb-6752-4c5d-9f56-d2d450b7260c" -k "https://services.cancerimagingarchive.net/nbia-api/services/getThumbnail" -d "seriesUID=1.3.6.1.4.1.14519.5.2.1.3023.4024.536949365601910993926257264114&objectUID=1.3.6.1.4.1.14519.5.2.1.3023.4024.822829852603295162591249163632" --output Thumbnail.jpg |
The API returns a JPG thumbnail.
Text Search API
The text search API is used to run queries for Text Search in the portal. The text search takes an argument, textValue.
Example Text Search Query
Code Block | ||
---|---|---|
| ||
curl -H "Authorization:Bearer 946bddb4-d076-4fb1-8dff-81fb64d6f921" -k "https://services.cancerimagingarchive.net/nbia-api/services/getTextSearch" -d "textValue=lung" |
Note that the returned JSON now includes the "hit" that was found by the Solr search engine.
Code Block | ||
---|---|---|
| ||
[{
"subjectId":"Project-3076386612",
"project":"Project",
"id":1277952,
"totalNumberOfStudies":1,
"totalNumberOfSeries":1,
"hit":"<em>seriesDesc</em>: <strong>LUNG</strong>",
"studyIdentifiers":[{
"seriesIdentifiers":[1376256],
"studyIdentifier":1310720
}]
}] |
Updated Series API
This API returns the series that have been updated since a given date.
The API takes one argument:
- fromDate - the date to get the updates have happened
Example Get Updated Series Query
Code Block | ||
---|---|---|
| ||
curl -H "Authorization:Bearer 86d45ad0-2e48-4f10-bbbe-593d7176fe30" -k "http://services.cancerimagingarchive.net/nbia-api/services/v2/getUpdatedSeries?fromDate=01/01/2020" |
The API returns the updated series.
.1700.131126392922209124942161386151 |
MD5 Hierarchy
Example getMD5Hierarchy Query
Code Block | ||
---|---|---|
| ||
curl -H "Authorization:Bearer YOUR_ACCESS_TOKEN" -k "https://services.cancerimagingarchive.net/nbia-api/services/getMD5Hierarchy" -d "Collection=ISPY1" |
Code Block | ||
---|---|---|
| ||
ce9ec0fd7cb437e5cd6b65cf358eea6a |
Manufacturer Values and Counts API
Example getManufacturerValuesAndCounts Query
Code Block | ||
---|---|---|
| ||
curl -H "Authorization:Bearer YOUR_ACCESS_TOKEN" -k "https://services.cancerimagingarchive.net/nbia-api/services/getManufacturerValuesAndCounts?Collection=4D-Lung" |
Code Block | ||
---|---|---|
| ||
[{"criteria":"ADAC","count":"20"},{"criteria":"Varian Imaging Laboratories, Switzerland","count":"20"}] |
MD5 Hash for Image
Generates an MD5 Hierarchy for a given Collection, PatientID, StudyInstanceUID, or SeriesInstanceUID, which can be compared to a previously generated hierarchy to determine if any changes have occurred to the data.
The API takes one argument:
- sopInstanceUid
Example MD5 Hash for Image Query
Code Block | ||
---|---|---|
| ||
curl -H "Authorization:Bearer YOUR_ACCESS_TOKEN" -k "https://services.cancerimagingarchive.net/nbia-api/services/v2/getM5HashForImage?SOPInstanceUid=1.3.6.1.4.1.14519.5.2.1.6834.5010.129790817462380794533151446268" |
Code Block | ||
---|---|---|
| ||
f9a9afbc6a5295cead66f43a5965080d |
Modality Values and Counts
The Modality Values and Counts API returns the modality values plus the subject count for the modality. It optionally takes the following parameters.
- Collection
- BodyPartExamined
Example Modality Values and Counts Query
Code Block | ||
---|---|---|
| ||
curl -H "Authorization:Bearer YOUR_ACCESS_TOKEN" -k "https://services.cancerimagingarchive.net/nbia-api/services/getModalityValuesAndCounts?Collection=VICTRE" |
The API returns the modalities and their counts.
Code Block | ||
---|---|---|
| ||
[{"criteria":"MG","count":"2994"}] |
Restrictions for Simple Search
The Restrictions on Simple Search API returns whether any series returned by simple search has commercial restrictions.
The API takes the same parameters as the Simple Search GUI.
Example getRestrictionsForSimpleSearch Query
Code Block | ||
---|---|---|
| ||
curl -H "Authorization:Bearer YOUR_ACCESS_TOKEN" -k "https://services.cancerimagingarchive.net/nbia-api/services/getRestrictionsForSimpleSearch" -d "criteriaType0=ThirdPartyAnalysis&value0=yes&sortField=subject&sortDirection=descending&start=0&size=1000000" |
The API returns "Yes" if there are commercial restrictions and "No" if there are not.
Series Metadata 2
The Series Metadata API allows returns the metadata needed by the client for a set of series as CSV.
Example Series Metadata 2 Query
Code Block | ||
---|---|---|
| ||
curl -H "Authorization:Bearer YOUR_ACCESS_TOKEN" -k https://services.cancerimagingarchive.net/nbia-api/services/getSeriesMetadata2" -d "list=2.25.110315838408248624082166543013557943798" |
The API returns ok if successful, and the error if one occurs.
Code Block | ||
---|---|---|
| ||
"Subject ID","Study UID","Study Description","Study Date","Series ID","Series Description","Number of images","File Size (Bytes)","Collection Name","Modality","Manufacturer","3rd Party Analysis","Data Description URI","Series Number","License Name","License URL","Date Released","Series Date","Protocol Name","Body Part Examined","Annotations Flag","Manufacturer Model Name","Software Versions","TimeStamp"
"9189822998","2.25.144594706293612984382396531662084750838","CT HIP W/O CONTRAST,BILAT","1989-02-15","2.25.110315838408248624082166543013557943798","Surview Test","5","3414180","Col4","CT","Philips","NO","","5865","Creative Commons Attribution 3.0 Unported License","http://creativecommons.org/licenses/by/3.0/","","","Abd/Pelvis W/C/Abdomen/Sv","BLADDER","","Mx8000 IDT 16","3.2.0","2023-11-28 20:29:48.0" |
Species Tax
The Species Tax API returns the species taxonomy and takes no parameters.
Example Species Tax Query
Code Block | ||
---|---|---|
| ||
curl -H "Authorization:Bearer YOUR_ACCESS_TOKEN" -k https://services.cancerimagingarchive.net/nbia-api/services/getSpeciesTax |
The API returns the current species taxonomy.
Code Block | ||
---|---|---|
| ||
[{"speciesCode":"447612001","speciesDescription":"Mus musculus"},{"speciesCode":"448771007","speciesDescription":"Canis lupus familiaris"},{"speciesCode":"337915000","speciesDescription":"Homo sapiens"}] |
Species Values And Counts
The Get Species Values And Counts API returns the values and counts for species and takes the same parameters as the Simple Search GUI.
Example Species Values And Counts Query
Code Block |
---|
curl -H "Authorization:Bearer YOUR_ACCESS_TOKEN" -k "https://services.cancerimagingarchive.net/nbia-api/services/getSpeciesValuesAndCounts" |
The API returns the values and counts for species.
Code Block | ||
---|---|---|
| ||
[{"criteria":"337915000","count":"33793"},{"criteria":"447612001","count":"393"},{"criteria":"448771007","count":"57"}] |
Study Drill Down With Series IDs
The Study Drill Down API provides the functionality in the portal where the user drills down to the studies and series associated with a given user.
The API takes a list of series to query, using the parameter "list," that is repeated for each series instance UIDs you want to retrieve.
Example Study Drill Down With Series IDs Query
Code Block | ||
---|---|---|
| ||
curl -H "Authorization:Bearer YOUR_ACCESS_TOKEN" -k "https://services.cancerimagingarchive.net/nbia-api/services/getStudyDrillDownWithSeriesIds" -d "list=1.3.6.1.4.1.14519.5.2.1.6834.5010.322628904903035357840500590726" |
The Study Drill Down With Series Ids API returns JSON with the information to populate the drill down to study screen. There can be multiple studies.
Code Block | ||
---|---|---|
| ||
[{"studyId":"1.3.6.1.4.1.14519.5.2.1.6834.5010.335014117706890137582032169351","date":874299600000,"description":"p4","id":221806615,"study_id":null,"excludeCommercial":null,"seriesList":[{"seriesNumber":"500","seriesUID":"1.3.6.1.4.1.14519.5.2.1.6834.5010.322628904903035357840500590726","numberImages":50,"modality":"CT","manufacturer":"Varian Imaging Laboratories, Switzerland","annotationsFlag":false,"annotationsSize":0,"patientId":"100_HM10395","patientPkId":"221773824","studyId":"1.3.6.1.4.1.14519.5.2.1.6834.5010.335014117706890137582032169351","studyPkId":221806615,"totalSizeForAllImagesInSeries":26405888,"project":"4D-Lung","description":"P4^P100^S100^I0, Gated, 0.0%","dataProvenanceSiteName":null,"manufacturerModelName":null,"softwareVersion":null,"maxFrameCount":"0","studyDate":null,"studyDesc":null,"bodyPartExamined":"LUNG","study_id":null,"thirdPartyAnalysis":null,"descriptionURI":"https://doi.org/10.7937/K9/TCIA.2016.ELN8YGLE","sopClassUID":null,"licenseName":null,"licenseUrl":null,"commercialRestrictions":false,"seriesId":"1.3.6.1.4.1.14519.5.2.1.6834.5010.322628904903035357840500590726","studyDateString":"","seriesPkId":221872172,"exactSize":26405888}]}] |
Thumbnail
The Get Thumbnail API returns the DICOM tags and values associated with the image.
- seriesUID
- objectUID
Example Thumbnail Query
Code Block | ||
---|---|---|
| ||
curl -H "Authorization:Bearer YOUR_ACCESS_TOKEN" -k "https://services.cancerimagingarchive.net/nbia-api/services/getThumbnail" -d "seriesUID=1.3.6.1.4.1.14519.5.2.1.3023.4024.536949365601910993926257264114&objectUID=1.3.6.1.4.1.14519.5.2.1.3023.4024.822829852603295162591249163632" --output Thumbnail.jpg |
The API returns a JPG thumbnail.
Code Block | ||
---|---|---|
| ||
" % Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
100 13757 0 13608 100 149 13608 149 0:00:01 --:--:-- 0:00:01 14435" |
Text Search
The text search API is used to run queries for Text Search in the portal. The text search takes an argument, textValue.
Example Text Search Query
Code Block | ||
---|---|---|
| ||
curl -H "Authorization:Bearer YOUR_ACCESS_TOKEN" -X POST "https://services.cancerimagingarchive.net/nbia-api/services/getTextSearch" -d "textValue=mouse" |
Note that the returned JSON now includes the "hit" that was found by the Solr search engine.
Code Block | ||
---|---|---|
| ||
[{"subjectId":"292921-168-R-1404","project":"PDMR-292921-168-R","id":716669003,"totalNumberOfStudies":4,"totalNumberOfSeries":7,"hit":"<em>seriesDesc</em>: PDM <strong>Mouse</strong> Overview","studyIdentifiers":[{"seriesIdentifiers":[716734938,716734939],"seriesAndModality":[],"studyIdentifier":716701807},{"seriesIdentifiers":[716734940,716734941],"seriesAndModality":[],"studyIdentifier":716701808},{"seriesIdentifiers":[716734942,716734943],"seriesAndModality":[],"studyIdentifier":716701809},{"seriesIdentifiers":[716734944],"seriesAndModality":[],"studyIdentifier":716701810}]},{"subjectId":"292921-168-R-1405","project":"PDMR-292921-168-R","id":679608323,"totalNumberOfStudies":5,"totalNumberOfSeries":9,"hit":"<em>seriesDesc</em>: PDM <strong>Mouse</strong> Overview","studyIdentifiers":[{"seriesIdentifiers":[679706630,679706631],"seriesAndModality":[],"studyIdentifier":679641091},{"seriesIdentifiers":[716734890,716734891],"seriesAndModality":[],"studyIdentifier":716701780},{"seriesIdentifiers":[716734892],"seriesAndModality":[],"studyIdentifier":716701781},{"seriesIdentifiers":[716734893,716734894],"seriesAndModality":[],"studyIdentifier":716701782},{"seriesIdentifiers":[716734895,716734896],"seriesAndModality":[],"studyIdentifier":716701783}]},{"subjectId":"292921-168-R-1406","project":"PDMR-292921-168-R","id":716668994,"totalNumberOfStudies":4,"totalNumberOfSeries":7,"hit":"<em>seriesDesc</em>: PDM <strong>Mouse</strong> Overview","studyIdentifiers":[{"seriesIdentifiers":[716734867],"seriesAndModality":[],"studyIdentifier":716701766},{"seriesIdentifiers":[716734868,716734869],"seriesAndModality":[],"studyIdentifier":716701767},{"seriesIdentifiers":[716734870,716734871],"seriesAndModality":[],"studyIdentifier":716701768},{"seriesIdentifiers":[716734872,716734873],"seriesAndModality":[],"studyIdentifier":716701769}]},{"subjectId":"292921-168-R-1407","project":"PDMR-292921-168-R","id":679608326,"totalNumberOfStudies":5,"totalNumberOfSeries":9,"hit":"<em>seriesDesc</em>: PDM <strong>Mouse</strong> Overview","studyIdentifiers":[{"seriesIdentifiers":[679706636,679706637],"seriesAndModality":[],"studyIdentifier":679641094},{"seriesIdentifiers":[716734966,716734967],"seriesAndModality":[],"studyIdentifier":716701823},{"seriesIdentifiers":[716734968,716734969],"seriesAndModality":[],"studyIdentifier":716701824},{"seriesIdentifiers":[716734970,716734971],"seriesAndModality":[],"studyIdentifier":716701825},{"seriesIdentifiers":[716734972],"seriesAndModality":[],"studyIdentifier":716701826}]},{"subjectId":"292921-168-R-1408","project":"PDMR-292921-168-R","id":679608325,"totalNumberOfStudies":5,"totalNumberOfSeries":9,"hit":"<em>seriesDesc</em>: PDM <strong>Mouse</strong> Overview","studyIdentifiers":[{"seriesIdentifiers":[679706634,679706635],"seriesAndModality":[],"studyIdentifier":679641093},{"seriesIdentifiers":[716734981,716734982],"seriesAndModality":[],"studyIdentifier":716701832},{"seriesIdentifiers":[716734983,716734984],"seriesAndModality":[],"studyIdentifier":716701833},{"seriesIdentifiers":[716734985],"seriesAndModality":[],"studyIdentifier":716701834},{"seriesIdentifiers":[716734986,716734987],"seriesAndModality":[],"studyIdentifier":716701835}]},{"subjectId":"292921-168-R-1409","project":"PDMR-292921-168-R","id":716668996,"totalNumberOfStudies":4,"totalNumberOfSeries":7,"hit":"<em>seriesDesc</em>: PDM <strong>Mouse</strong> Overview","studyIdentifiers":[{"seriesIdentifiers":[716734875,716734876],"seriesAndModality":[],"studyIdentifier":716701771},{"seriesIdentifiers":[716734877,716734878],"seriesAndModality":[],"studyIdentifier":716701772},{"seriesIdentifiers":[716734879,716734880],"seriesAndModality":[],"studyIdentifier":716701773},{"seriesIdentifiers":[716734881],"seriesAndModality":[],"studyIdentifier":716701774}]},{"subjectId":"292921-168-R-1410","project":"PDMR-292921-168-R","id":679608327,"totalNumberOfStudies":5,"totalNumberOfSeries":9,"hit":"<em>seriesDesc</em>: PDM <strong>Mouse</strong> Overview","studyIdentifiers":[{"seriesIdentifiers":[679706638,679706639],"seriesAndModality":[],"studyIdentifier":679641095},{"seriesIdentifiers":[716734918,716734919],"seriesAndModality":[],"studyIdentifier":716701796},{"seriesIdentifiers":[716734920,716734921],"seriesAndModality":[],"studyIdentifier":716701797},{"seriesIdentifiers":[716734922],"seriesAndModality":[],"studyIdentifier":716701798},{"seriesIdentifiers":[716734923,716734924],"seriesAndModality":[],"studyIdentifier":716701799}]},{"subjectId":"292921-168-R-1411","project":"PDMR-292921-168-R","id":679608321,"totalNumberOfStudies":5,"totalNumberOfSeries":9,"hit":"<em>seriesDesc</em>: PDM <strong>Mouse</strong> Overview","studyIdentifiers":[{"seriesIdentifiers":[679706626,679706627],"seriesAndModality":[],"studyIdentifier":679641089},{"seriesIdentifiers":[716734996],"seriesAndModality":[],"studyIdentifier":716701841},{"seriesIdentifiers":[716734997,716734998],"seriesAndModality":[],"studyIdentifier":716701842},{"seriesIdentifiers":[716734999,716735000],"seriesAndModality":[],"studyIdentifier":716701843},{"seriesIdentifiers":[716735001,716735002],"seriesAndModality":[],"studyIdentifier":716701844}]},{"subjectId":"292921-168-R-1412","project":"PDMR-292921-168-R","id":716668993,"totalNumberOfStudies":4,"totalNumberOfSeries":7,"hit":"<em>seriesDesc</em>: PDM <strong>Mouse</strong> Overview","studyIdentifiers":[{"seriesIdentifiers":[716734860],"seriesAndModality":[],"studyIdentifier":716701762},{"seriesIdentifiers":[716734861,716734862],"seriesAndModality":[],"studyIdentifier":716701763},{"seriesIdentifiers":[716734863,716734864],"seriesAndModality":[],"studyIdentifier":716701764},{"seriesIdentifiers":[716734865,716734866],"seriesAndModality":[],"studyIdentifier":716701765}]},{"subjectId":"292921-168-R-1413","project":"PDMR-292921-168-R","id":679608328,"totalNumberOfStudies":5,"totalNumberOfSeries":9,"hit":"<em>seriesDesc</em>: PDM <strong>Mouse</strong> Overview","studyIdentifiers":[{"seriesIdentifiers":[679706640,679706641],"seriesAndModality":[],"studyIdentifier":679641096},{"seriesIdentifiers":[716734904,716734905],"seriesAndModality":[],"studyIdentifier":716701788},{"seriesIdentifiers":[716734906,716734907],"seriesAndModality":[],"studyIdentifier":716701789},{"seriesIdentifiers":[716734908],"seriesAndModality":[],"studyIdentifier":716701790},{"seriesIdentifiers":[716734909,716734910],"seriesAndModality":[],"studyIdentifier":716701791}]},{"subjectId":"292921-168-R-1414","project":"PDMR-292921-168-R","id":716669004,"totalNumberOfStudies":4,"totalNumberOfSeries":7,"hit":"<em>seriesDesc</em>: PDM <strong>Mouse</strong> Overview","studyIdentifiers":[{"seriesIdentifiers":[716734945],"seriesAndModality":[],"studyIdentifier":716701811},{"seriesIdentifiers":[716734946,716734947],"seriesAndModality":[],"studyIdentifier":716701812},{"seriesIdentifiers":[716734948,716734949],"seriesAndModality":[],"studyIdentifier":716701813},{"seriesIdentifiers":[716734950,716734951],"seriesAndModality":[],"studyIdentifier":716701814}]},{"subjectId":"292921-168-R-1415","project":"PDMR-292921-168-R","id":679608329,"totalNumberOfStudies":5,"totalNumberOfSeries":9,"hit":"<em>seriesDesc</em>: PDM <strong>Mouse</strong> Overview","studyIdentifiers":[{"seriesIdentifiers":[679706642,679706643],"seriesAndModality":[],"studyIdentifier":679641097},{"seriesIdentifiers":[716734988,716734989],"seriesAndModality":[],"studyIdentifier":716701836},{"seriesIdentifiers":[716734990,716734991],"seriesAndModality":[],"studyIdentifier":716701837},{"seriesIdentifiers":[716734992,716734993],"seriesAndModality":[],"studyIdentifier":716701838},{"seriesIdentifiers":[716734994],"seriesAndModality":[],"studyIdentifier":716701839}]},{"subjectId":"292921-168-R-1416","project":"PDMR-292921-168-R","id":679608324,"totalNumberOfStudies":5,"totalNumberOfSeries":9,"hit":"<em>seriesDesc</em>: PDM <strong>Mouse</strong> Overview","studyIdentifiers":[{"seriesIdentifiers":[679706632,679706633],"seriesAndModality":[],"studyIdentifier":679641092},{"seriesIdentifiers":[716734959,716734960],"seriesAndModality":[],"studyIdentifier":716701819},{"seriesIdentifiers":[716734961],"seriesAndModality":[],"studyIdentifier":716701820},{"seriesIdentifiers":[716734962,716734963],"seriesAndModality":[],"studyIdentifier":716701821},{"seriesIdentifiers":[716734964,716734965],"seriesAndModality":[],"studyIdentifier":716701822}]},{"subjectId":"292921-168-R-1417","project":"PDMR-292921-168-R","id":716668999,"totalNumberOfStudies":4,"totalNumberOfSeries":7,"hit":"<em>seriesDesc</em>: PDM <strong>Mouse</strong> Overview","studyIdentifiers":[{"seriesIdentifiers":[716734911],"seriesAndModality":[],"studyIdentifier":716701792},{"seriesIdentifiers":[716734912,716734913],"seriesAndModality":[],"studyIdentifier":716701793},{"seriesIdentifiers":[716734914,716734915],"seriesAndModality":[],"studyIdentifier":716701794},{"seriesIdentifiers":[716734916,716734917],"seriesAndModality":[],"studyIdentifier":716701795}]},{"subjectId":"292921-168-R-1418","project":"PDMR-292921-168-R","id":716669006,"totalNumberOfStudies":4,"totalNumberOfSeries":7,"hit":"<em>seriesDesc</em>: PDM <strong>Mouse</strong> Overview","studyIdentifiers":[{"seriesIdentifiers":[716734974],"seriesAndModality":[],"studyIdentifier":716701828},{"seriesIdentifiers":[716734975,716734976],"seriesAndModality":[],"studyIdentifier":716701829},{"seriesIdentifiers":[716734977,716734978],"seriesAndModality":[],"studyIdentifier":716701830},{"seriesIdentifiers":[716734979,716734980],"seriesAndModality":[],"studyIdentifier":716701831}]},{"subjectId":"292921-168-R-1419","project":"PDMR-292921-168-R","id":679608330,"totalNumberOfStudies":5,"totalNumberOfSeries":9,"hit":"<em>seriesDesc</em>: PDM <strong>Mouse</strong> Overview","studyIdentifiers":[{"seriesIdentifiers":[679706644,679706645],"seriesAndModality":[],"studyIdentifier":679641098},{"seriesIdentifiers":[716734882,716734883],"seriesAndModality":[],"studyIdentifier":716701775},{"seriesIdentifiers":[716734884,716734885],"seriesAndModality":[],"studyIdentifier":716701776},{"seriesIdentifiers":[716734886],"seriesAndModality":[],"studyIdentifier":716701777},{"seriesIdentifiers":[716734887,716734888],"seriesAndModality":[],"studyIdentifier":716701778}]},{"subjectId":"292921-168-R-1420","project":"PDMR-292921-168-R","id":679608322,"totalNumberOfStudies":5,"totalNumberOfSeries":9,"hit":"<em>seriesDesc</em>: PDM <strong>Mouse</strong> Overview","studyIdentifiers":[{"seriesIdentifiers":[679706628,679706629],"seriesAndModality":[],"studyIdentifier":679641090},{"seriesIdentifiers":[716734952,716734953],"seriesAndModality":[],"studyIdentifier":716701815},{"seriesIdentifiers":[716734954,716734955],"seriesAndModality":[],"studyIdentifier":716701816},{"seriesIdentifiers":[716734956,716734957],"seriesAndModality":[],"studyIdentifier":716701817},{"seriesIdentifiers":[716734958],"seriesAndModality":[],"studyIdentifier":716701818}]},{"subjectId":"292921-168-R-1421","project":"PDMR-292921-168-R","id":716668998,"totalNumberOfStudies":4,"totalNumberOfSeries":7,"hit":"<em>seriesDesc</em>: PDM <strong>Mouse</strong> Overview","studyIdentifiers":[{"seriesIdentifiers":[716734897,716734898],"seriesAndModality":[],"studyIdentifier":716701784},{"seriesIdentifiers":[716734899],"seriesAndModality":[],"studyIdentifier":716701785},{"seriesIdentifiers":[716734900,716734901],"seriesAndModality":[],"studyIdentifier":716701786},{"seriesIdentifiers":[716734902,716734903],"seriesAndModality":[],"studyIdentifier":716701787}]},{"subjectId":"425362-245-T-1505","project":"PDMR-425362-245-T","id":737935370,"totalNumberOfStudies":4,"totalNumberOfSeries":7,"hit":"<em>seriesDesc</em>: PDM <strong>Mouse</strong> Overview","studyIdentifiers":[{"seriesIdentifiers":[738000906],"seriesAndModality":[],"studyIdentifier":737968138},{"seriesIdentifiers":[738000907,738000909],"seriesAndModality":[],"studyIdentifier":737968139},{"seriesIdentifiers":[738000908,738000911],"seriesAndModality":[],"studyIdentifier":737968140},{"seriesIdentifiers":[738000910,738000912],"seriesAndModality":[],"studyIdentifier":737968141}]},{"subjectId":"425362-245-T-1506","project":"PDMR-425362-245-T","id":737935371,"totalNumberOfStudies":6,"totalNumberOfSeries":11,"hit":"<em>seriesDesc</em>: PDM <strong>Mouse</strong> Overview","studyIdentifiers":[{"seriesIdentifiers":[738000913,738000916],"seriesAndModality":[],"studyIdentifier":737968142},{"seriesIdentifiers":[738000914],"seriesAndModality":[],"studyIdentifier":737968143},{"seriesIdentifiers":[738000915,738000918],"seriesAndModality":[],"studyIdentifier":737968144},{"seriesIdentifiers":[738000917,738000919],"seriesAndModality":[],"studyIdentifier":737968145},{"seriesIdentifiers":[738000920,738000921],"seriesAndModality":[],"studyIdentifier":737968146},{"seriesIdentifiers":[738000922,738000925],"seriesAndModality":[],"studyIdentifier":737968147}]},{"subjectId":"425362-245-T-1507","project":"PDMR-425362-245-T","id":737935372,"totalNumberOfStudies":4,"totalNumberOfSeries":7,"hit":"<em>seriesDesc</em>: PDM <strong>Mouse</strong> Overview","studyIdentifiers":[{"seriesIdentifiers":[738000923,738000927],"seriesAndModality":[],"studyIdentifier":737968148},{"seriesIdentifiers":[738000924],"seriesAndModality":[],"studyIdentifier":737968149},{"seriesIdentifiers":[738000926,738000929],"seriesAndModality":[],"studyIdentifier":737968150},{"seriesIdentifiers":[738000928,738000932],"seriesAndModality":[],"studyIdentifier":737968151}]},{"subjectId":"425362-245-T-1508","project":"PDMR-425362-245-T","id":737935373,"totalNumberOfStudies":7,"totalNumberOfSeries":13,"hit":"<em>seriesDesc</em>: PDM <strong>Mouse</strong> Overview","studyIdentifiers":[{"seriesIdentifiers":[738000930,738000934],"seriesAndModality":[],"studyIdentifier":737968152},{"seriesIdentifiers":[738000931],"seriesAndModality":[],"studyIdentifier":737968153},{"seriesIdentifiers":[738000933,738000935],"seriesAndModality":[],"studyIdentifier":737968154},{"seriesIdentifiers":[738000936,738000938],"seriesAndModality":[],"studyIdentifier":737968155},{"seriesIdentifiers":[738000937,738000942],"seriesAndModality":[],"studyIdentifier":737968156},{"seriesIdentifiers":[738000939,738000941],"seriesAndModality":[],"studyIdentifier":737968157},{"seriesIdentifiers":[738000940,738000943],"seriesAndModality":[],"studyIdentifier":737968158}]},{"subjectId":"425362-245-T-1509","project":"PDMR-425362-245-T","id":737935374,"totalNumberOfStudies":6,"totalNumberOfSeries":11,"hit":"<em>seriesDesc</em>: PDM <strong>Mouse</strong> Overview","studyIdentifiers":[{"seriesIdentifiers":[738000944,738000946],"seriesAndModality":[],"studyIdentifier":737968159},{"seriesIdentifiers":[738000945,738000949],"seriesAndModality":[],"studyIdentifier":737968160},{"seriesIdentifiers":[738000947],"seriesAndModality":[],"studyIdentifier":737968161},{"seriesIdentifiers":[738000948,738000950],"seriesAndModality":[],"studyIdentifier":737968162},{"seriesIdentifiers":[738000951,738000953],"seriesAndModality":[],"studyIdentifier":737968163},{"seriesIdentifiers":[738000952,738000954],"seriesAndModality":[],"studyIdentifier":737968164}]},{"subjectId":"425362-245-T-1510","project":"PDMR-425362-245-T","id":737935375,"totalNumberOfStudies":7,"totalNumberOfSeries":13,"hit":"<em>seriesDesc</em>: PDM <strong>Mouse</strong> Overview","studyIdentifiers":[{"seriesIdentifiers":[738000955],"seriesAndModality":[],"studyIdentifier":737968165},{"seriesIdentifiers":[738000956,738000957],"seriesAndModality":[],"studyIdentifier":737968166},{"seriesIdentifiers":[738000958,738000960],"seriesAndModality":[],"studyIdentifier":737968167},{"seriesIdentifiers":[738000959,738000961],"seriesAndModality":[],"studyIdentifier":737968168},{"seriesIdentifiers":[738000962,738000964],"seriesAndModality":[],"studyIdentifier":737968169},{"seriesIdentifiers":[738000963,738000966],"seriesAndModality":[],"studyIdentifier":737968170},{"seriesIdentifiers":[738000965,738000967],"seriesAndModality":[],"studyIdentifier":737968171}]},{"subjectId":"425362-245-T-1511","project":"PDMR-425362-245-T","id":737935376,"totalNumberOfStudies":7,"totalNumberOfSeries":13,"hit":"<em>seriesDesc</em>: PDM <strong>Mouse</strong> Overview","studyIdentifiers":[{"seriesIdentifiers":[738000968,738000969],"seriesAndModality":[],"studyIdentifier":737968172},{"seriesIdentifiers":[738000970,738000972],"seriesAndModality":[],"studyIdentifier":737968173},{"seriesIdentifiers":[738000971],"seriesAndModality":[],"studyIdentifier":737968174},{"seriesIdentifiers":[738000973,738000975],"seriesAndModality":[],"studyIdentifier":737968175},{"seriesIdentifiers":[738000974,738000977],"seriesAndModality":[],"studyIdentifier":737968176},{"seriesIdentifiers":[738000976,738000981],"seriesAndModality":[],"studyIdentifier":737968177},{"seriesIdentifiers":[738000978,738000980],"seriesAndModality":[],"studyIdentifier":737968178}]},{"subjectId":"425362-245-T-1512","project":"PDMR-425362-245-T","id":737935377,"totalNumberOfStudies":3,"totalNumberOfSeries":5,"hit":"<em>seriesDesc</em>: PDM <strong>Mouse</strong> Overview","studyIdentifiers":[{"seriesIdentifiers":[738000979,738000986],"seriesAndModality":[],"studyIdentifier":737968179},{"seriesIdentifiers":[738000982],"seriesAndModality":[],"studyIdentifier":737968180},{"seriesIdentifiers":[738000983,738000984],"seriesAndModality":[],"studyIdentifier":737968181}]},{"subjectId":"425362-245-T-1513","project":"PDMR-425362-245-T","id":737935378,"totalNumberOfStudies":4,"totalNumberOfSeries":7,"hit":"<em>seriesDesc</em>: PDM <strong>Mouse</strong> Overview","studyIdentifiers":[{"seriesIdentifiers":[738000985,738000991],"seriesAndModality":[],"studyIdentifier":737968182},{"seriesIdentifiers":[738000987],"seriesAndModality":[],"studyIdentifier":737968183},{"seriesIdentifiers":[738000988,738000989],"seriesAndModality":[],"studyIdentifier":737968184},{"seriesIdentifiers":[738000990,738000993],"seriesAndModality":[],"studyIdentifier":737968185}]},{"subjectId":"425362-245-T-1514","project":"PDMR-425362-245-T","id":737935379,"totalNumberOfStudies":4,"totalNumberOfSeries":7,"hit":"<em>seriesDesc</em>: PDM <strong>Mouse</strong> Overview","studyIdentifiers":[{"seriesIdentifiers":[738000992,738000996],"seriesAndModality":[],"studyIdentifier":737968186},{"seriesIdentifiers":[738000994,738000997],"seriesAndModality":[],"studyIdentifier":737968187},{"seriesIdentifiers":[738000995],"seriesAndModality":[],"studyIdentifier":737968188},{"seriesIdentifiers":[738000998,738001001],"seriesAndModality":[],"studyIdentifier":737968189}]},{"subjectId":"425362-245-T-1515","project":"PDMR-425362-245-T","id":737935380,"totalNumberOfStudies":7,"totalNumberOfSeries":13,"hit":"<em>seriesDesc</em>: PDM <strong>Mouse</strong> Overview","studyIdentifiers":[{"seriesIdentifiers":[738000999,738001003],"seriesAndModality":[],"studyIdentifier":737968190},{"seriesIdentifiers":[738001000],"seriesAndModality":[],"studyIdentifier":737968191},{"seriesIdentifiers":[738001002,738001005],"seriesAndModality":[],"studyIdentifier":737968192},{"seriesIdentifiers":[738001004,738001007],"seriesAndModality":[],"studyIdentifier":737968193},{"seriesIdentifiers":[738001006,738001011],"seriesAndModality":[],"studyIdentifier":737968194},{"seriesIdentifiers":[738001008,738001010],"seriesAndModality":[],"studyIdentifier":737968195},{"seriesIdentifiers":[738001009,738001012],"seriesAndModality":[],"studyIdentifier":737968196}]},{"subjectId":"425362-245-T-1516","project":"PDMR-425362-245-T","id":737935381,"totalNumberOfStudies":7,"totalNumberOfSeries":13,"hit":"<em>seriesDesc</em>: PDM <strong>Mouse</strong> Overview","studyIdentifiers":[{"seriesIdentifiers":[738001013,738001016],"seriesAndModality":[],"studyIdentifier":737968197},{"seriesIdentifiers":[738001014,738001017],"seriesAndModality":[],"studyIdentifier":737968198},{"seriesIdentifiers":[738001015],"seriesAndModality":[],"studyIdentifier":737968199},{"seriesIdentifiers":[738001018,738001020],"seriesAndModality":[],"studyIdentifier":737968200},{"seriesIdentifiers":[738001019,738001022],"seriesAndModality":[],"studyIdentifier":737968201},{"seriesIdentifiers":[738001021,738001024],"seriesAndModality":[],"studyIdentifier":737968202},{"seriesIdentifiers":[738001023,738001027],"seriesAndModality":[],"studyIdentifier":737968203}]},{"subjectId":"425362-245-T-1517","project":"PDMR-425362-245-T","id":737935382,"totalNumberOfStudies":8,"totalNumberOfSeries":15,"hit":"<em>seriesDesc</em>: PDM <strong>Mouse</strong> Overview","studyIdentifiers":[{"seriesIdentifiers":[738001025,738001028],"seriesAndModality":[],"studyIdentifier":737968204},{"seriesIdentifiers":[738001026],"seriesAndModality":[],"studyIdentifier":737968205},{"seriesIdentifiers":[738001029,738001031],"seriesAndModality":[],"studyIdentifier":737968206},{"seriesIdentifiers":[738001030,738001033],"seriesAndModality":[],"studyIdentifier":737968207},{"seriesIdentifiers":[738001032,738001035],"seriesAndModality":[],"studyIdentifier":737968208},{"seriesIdentifiers":[738001034,738001036],"seriesAndModality":[],"studyIdentifier":737968209},{"seriesIdentifiers":[738001037,738001039],"seriesAndModality":[],"studyIdentifier":737968210},{"seriesIdentifiers":[738001038,738001043],"seriesAndModality":[],"studyIdentifier":737968211}]},{"subjectId":"425362-245-T-1518","project":"PDMR-425362-245-T","id":737935383,"totalNumberOfStudies":7,"totalNumberOfSeries":13,"hit":"<em>seriesDesc</em>: PDM <strong>Mouse</strong> Overview","studyIdentifiers":[{"seriesIdentifiers":[738001040,738001044],"seriesAndModality":[],"studyIdentifier":737968212},{"seriesIdentifiers":[738001041],"seriesAndModality":[],"studyIdentifier":737968213},{"seriesIdentifiers":[738001042,738001046],"seriesAndModality":[],"studyIdentifier":737968214},{"seriesIdentifiers":[738001045,738001048],"seriesAndModality":[],"studyIdentifier":737968215},{"seriesIdentifiers":[738001047,738001050],"seriesAndModality":[],"studyIdentifier":737968216},{"seriesIdentifiers":[738001049,738001051],"seriesAndModality":[],"studyIdentifier":737968217},{"seriesIdentifiers":[738001052,738001054],"seriesAndModality":[],"studyIdentifier":737968218}]},{"subjectId":"425362-245-T-1519","project":"PDMR-425362-245-T","id":737935384,"totalNumberOfStudies":9,"totalNumberOfSeries":17,"hit":"<em>seriesDesc</em>: PDM <strong>Mouse</strong> Overview","studyIdentifiers":[{"seriesIdentifiers":[738001053,738001057],"seriesAndModality":[],"studyIdentifier":737968219},{"seriesIdentifiers":[738001055,738001059],"seriesAndModality":[],"studyIdentifier":737968220},{"seriesIdentifiers":[738001056],"seriesAndModality":[],"studyIdentifier":737968221},{"seriesIdentifiers":[738001058,738001061],"seriesAndModality":[],"studyIdentifier":737968222},{"seriesIdentifiers":[738001060,738001065],"seriesAndModality":[],"studyIdentifier":737968223},{"seriesIdentifiers":[738001062,738001064],"seriesAndModality":[],"studyIdentifier":737968224},{"seriesIdentifiers":[738001063,738001066],"seriesAndModality":[],"studyIdentifier":737968225},{"seriesIdentifiers":[738001067,738001071],"seriesAndModality":[],"studyIdentifier":737968226},{"seriesIdentifiers":[738001068,738001072],"seriesAndModality":[],"studyIdentifier":737968227}]},{"subjectId":"425362-245-T-1520","project":"PDMR-425362-245-T","id":737935385,"totalNumberOfStudies":5,"totalNumberOfSeries":9,"hit":"<em>seriesDesc</em>: PDM <strong>Mouse</strong> Overview","studyIdentifiers":[{"seriesIdentifiers":[738001069,738001074],"seriesAndModality":[],"studyIdentifier":737968228},{"seriesIdentifiers":[738001070],"seriesAndModality":[],"studyIdentifier":737968229},{"seriesIdentifiers":[738001073,738001076],"seriesAndModality":[],"studyIdentifier":737968230},{"seriesIdentifiers":[738001075,738001079],"seriesAndModality":[],"studyIdentifier":737968231},{"seriesIdentifiers":[738001077,738001080],"seriesAndModality":[],"studyIdentifier":737968232}]},{"subjectId":"425362-245-T-1521","project":"PDMR-425362-245-T","id":737935386,"totalNumberOfStudies":8,"totalNumberOfSeries":15,"hit":"<em>seriesDesc</em>: PDM <strong>Mouse</strong> Overview","studyIdentifiers":[{"seriesIdentifiers":[738001078,738001083],"seriesAndModality":[],"studyIdentifier":737968233},{"seriesIdentifiers":[738001081],"seriesAndModality":[],"studyIdentifier":737968234},{"seriesIdentifiers":[738001082,738001085],"seriesAndModality":[],"studyIdentifier":737968235},{"seriesIdentifiers":[738001084,738001087],"seriesAndModality":[],"studyIdentifier":737968236},{"seriesIdentifiers":[738001086,738001089],"seriesAndModality":[],"studyIdentifier":737968237},{"seriesIdentifiers":[738001088,738001092],"seriesAndModality":[],"studyIdentifier":737968238},{"seriesIdentifiers":[738001090,738001093],"seriesAndModality":[],"studyIdentifier":737968239},{"seriesIdentifiers":[738001091,738001095],"seriesAndModality":[],"studyIdentifier":737968240}]},{"subjectId":"425362-245-T-1522","project":"PDMR-425362-245-T","id":737935387,"totalNumberOfStudies":4,"totalNumberOfSeries":7,"hit":"<em>seriesDesc</em>: PDM <strong>Mouse</strong> Overview","studyIdentifiers":[{"seriesIdentifiers":[738001094,738001098],"seriesAndModality":[],"studyIdentifier":737968241},{"seriesIdentifiers":[738001096],"seriesAndModality":[],"studyIdentifier":737968242},{"seriesIdentifiers":[738001097,738001100],"seriesAndModality":[],"studyIdentifier":737968243},{"seriesIdentifiers":[738001099,738001102],"seriesAndModality":[],"studyIdentifier":737968244}]},{"subjectId":"425362-245-T-1523","project":"PDMR-425362-245-T","id":737935388,"totalNumberOfStudies":5,"totalNumberOfSeries":9,"hit":"<em>seriesDesc</em>: PDM <strong>Mouse</strong> Overview","studyIdentifiers":[{"seriesIdentifiers":[738001101,738001105],"seriesAndModality":[],"studyIdentifier":737968245},{"seriesIdentifiers":[738001103],"seriesAndModality":[],"studyIdentifier":737968246},{"seriesIdentifiers":[738001104,738001107],"seriesAndModality":[],"studyIdentifier":737968247},{"seriesIdentifiers":[738001106,738001109],"seriesAndModality":[],"studyIdentifier":737968248},{"seriesIdentifiers":[738001108,738001112],"seriesAndModality":[],"studyIdentifier":737968249}]},{"subjectId":"425362-245-T-1524","project":"PDMR-425362-245-T","id":737935389,"totalNumberOfStudies":3,"totalNumberOfSeries":5,"hit":"<em>seriesDesc</em>: PDM <strong>Mouse</strong> Overview","studyIdentifiers":[{"seriesIdentifiers":[738001110,738001113],"seriesAndModality":[],"studyIdentifier":737968250},{"seriesIdentifiers":[738001111],"seriesAndModality":[],"studyIdentifier":737968251},{"seriesIdentifiers":[738001114,738001115],"seriesAndModality":[],"studyIdentifier":737968252}]},{"subjectId":"521955-158-R4-2160","project":"PDMR-521955-158-R4","id":942342194,"totalNumberOfStudies":8,"totalNumberOfSeries":15,"hit":"<em>seriesDesc</em>: PDM <strong>Mouse</strong> Overview","studyIdentifiers":[{"seriesIdentifiers":[942442571,942442722],"seriesAndModality":[],"studyIdentifier":942375280},{"seriesIdentifiers":[942442585,942442676],"seriesAndModality":[],"studyIdentifier":942375294},{"seriesIdentifiers":[942442604,942442822],"seriesAndModality":[],"studyIdentifier":942375313},{"seriesIdentifiers":[942442617,942442707],"seriesAndModality":[],"studyIdentifier":942375325},{"seriesIdentifiers":[942442637,942442824],"seriesAndModality":[],"studyIdentifier":942375342},{"seriesIdentifiers":[942442654,942442766],"seriesAndModality":[],"studyIdentifier":942375357},{"seriesIdentifiers":[942442691,942442724],"seriesAndModality":[],"studyIdentifier":942375390},{"seriesIdentifiers":[942442814],"seriesAndModality":[],"studyIdentifier":942375415}]},{"subjectId":"521955-158-R4-2161","project":"PDMR-521955-158-R4","id":942342197,"totalNumberOfStudies":8,"totalNumberOfSeries":15,"hit":"<em>seriesDesc</em>: PDM <strong>Mouse</strong> Overview","studyIdentifiers":[{"seriesIdentifiers":[942442575,942442816],"seriesAndModality":[],"studyIdentifier":942375284},{"seriesIdentifiers":[942442592,942442740],"seriesAndModality":[],"studyIdentifier":942375301},{"seriesIdentifiers":[942442623,942442747],"seriesAndModality":[],"studyIdentifier":942375331},{"seriesIdentifiers":[942442625,942442829],"seriesAndModality":[],"studyIdentifier":942375333},{"seriesIdentifiers":[942442663,942442767],"seriesAndModality":[],"studyIdentifier":942375366},{"seriesIdentifiers":[942442677,942442805],"seriesAndModality":[],"studyIdentifier":942375377},{"seriesIdentifiers":[942442681,942442731],"seriesAndModality":[],"studyIdentifier":942375381},{"seriesIdentifiers":[942442801],"seriesAndModality":[],"studyIdentifier":942375414}]},{"subjectId":"521955-158-R4-2162","project":"PDMR-Texture-Analysis","id":1000412680,"totalNumberOfStudies":5,"totalNumberOfSeries":9,"hit":"<em>seriesDesc</em>: PDM <strong>Mouse</strong> Overview","studyIdentifiers":[{"seriesIdentifiers":[1000501150,1000501867],"seriesAndModality":[],"studyIdentifier":1000446952},{"seriesIdentifiers":[1000501567,1000502219],"seriesAndModality":[],"studyIdentifier":1000447348},{"seriesIdentifiers":[1000501623,1000501982],"seriesAndModality":[],"studyIdentifier":1000447396},{"seriesIdentifiers":[1000501748,1000501952],"seriesAndModality":[],"studyIdentifier":1000447481},{"seriesIdentifiers":[1000502311],"seriesAndModality":[],"studyIdentifier":1000447628}]},{"subjectId":"521955-158-R4-2162","project":"PDMR-521955-158-R4","id":942342203,"totalNumberOfStudies":6,"totalNumberOfSeries":11,"hit":"<em>seriesDesc</em>: PDM <strong>Mouse</strong> Overview","studyIdentifiers":[{"seriesIdentifiers":[942442584,942442796],"seriesAndModality":[],"studyIdentifier":942375293},{"seriesIdentifiers":[942442586,942442717],"seriesAndModality":[],"studyIdentifier":942375295},{"seriesIdentifiers":[942442589,942442613],"seriesAndModality":[],"studyIdentifier":942375298},{"seriesIdentifiers":[942442590,942442786],"seriesAndModality":[],"studyIdentifier":942375299},{"seriesIdentifiers":[942442596,942442812],"seriesAndModality":[],"studyIdentifier":942375305},{"seriesIdentifiers":[942442800],"seriesAndModality":[],"studyIdentifier":942375413}]},{"subjectId":"521955-158-R4-2163","project":"PDMR-521955-158-R4","id":942342206,"totalNumberOfStudies":7,"totalNumberOfSeries":13,"hit":"<em>seriesDesc</em>: PDM <strong>Mouse</strong> Overview","studyIdentifiers":[{"seriesIdentifiers":[942442597,942442818],"seriesAndModality":[],"studyIdentifier":942375306},{"seriesIdentifiers":[942442598,942442714],"seriesAndModality":[],"studyIdentifier":942375307},{"seriesIdentifiers":[942442607,942442775],"seriesAndModality":[],"studyIdentifier":942375316},{"seriesIdentifiers":[942442641,942442756],"seriesAndModality":[],"studyIdentifier":942375346},{"seriesIdentifiers":[942442684,942442820],"seriesAndModality":[],"studyIdentifier":942375384},{"seriesIdentifiers":[942442703,942442804],"seriesAndModality":[],"studyIdentifier":942375397},{"seriesIdentifiers":[942442774],"seriesAndModality":[],"studyIdentifier":942375407}]},{"subjectId":"521955-158-R4-2163","project":"PDMR-Texture-Analysis","id":1000412795,"totalNumberOfStudies":5,"totalNumberOfSeries":9,"hit":"<em>seriesDesc</em>: PDM <strong>Mouse</strong> Overview","studyIdentifiers":[{"seriesIdentifiers":[1000501359,1000502285],"seriesAndModality":[],"studyIdentifier":1000447153},{"seriesIdentifiers":[1000501436,1000501679],"seriesAndModality":[],"studyIdentifier":1000447229},{"seriesIdentifiers":[1000501485,1000502301],"seriesAndModality":[],"studyIdentifier":1000447273},{"seriesIdentifiers":[1000501560,1000502055],"seriesAndModality":[],"studyIdentifier":1000447342},{"seriesIdentifiers":[1000502194],"seriesAndModality":[],"studyIdentifier":1000447592}]},{"subjectId":"521955-158-R4-2164","project":"PDMR-521955-158-R4","id":942342189,"totalNumberOfStudies":7,"totalNumberOfSeries":13,"hit":"<em>seriesDesc</em>: PDM <strong>Mouse</strong> Overview","studyIdentifiers":[{"seriesIdentifiers":[942442566],"seriesAndModality":[],"studyIdentifier":942375275},{"seriesIdentifiers":[942442600,942442635],"seriesAndModality":[],"studyIdentifier":942375309},{"seriesIdentifiers":[942442609,942442773],"seriesAndModality":[],"studyIdentifier":942375318},{"seriesIdentifiers":[942442629,942442713],"seriesAndModality":[],"studyIdentifier":942375336},{"seriesIdentifiers":[942442642,942442760],"seriesAndModality":[],"studyIdentifier":942375347},{"seriesIdentifiers":[942442644,942442712],"seriesAndModality":[],"studyIdentifier":942375349},{"seriesIdentifiers":[942442692,942442729],"seriesAndModality":[],"studyIdentifier":942375391}]},{"subjectId":"521955-158-R4-2165","project":"PDMR-521955-158-R4","id":942342208,"totalNumberOfStudies":7,"totalNumberOfSeries":13,"hit":"<em>seriesDesc</em>: PDM <strong>Mouse</strong> Overview","studyIdentifiers":[{"seriesIdentifiers":[942442610,942442798],"seriesAndModality":[],"studyIdentifier":942375319},{"seriesIdentifiers":[942442612,942442770],"seriesAndModality":[],"studyIdentifier":942375321},{"seriesIdentifiers":[94244262 | ||
Code Block | ||
| ||
[
{
"SeriesInstanceUID":"1.3.6.1.4.1.5962.1.1.0.0.1560173490.85106.1",
"StudyInstanceUID":"1.3.6.1.4.1.5962.1.1.0.1560173490.85106.1",
"Modality":"SR",
"SeriesDate":"2016-01-06 00:00:00.0",
"SeriesDescription":"PDM Mouse Overview",
"SeriesNumber":1,
"Collection":"Project",
"PatientID":"128783-104-T_VQ4",
"Manufacturer":"PixelMed",
"ManufacturerModelName":"XSLT",
"SoftwareVersions":"0.1",
"ImageCount":1
} |