Child pages
  • TCIA Programmatic Interface (REST API) Usage Guide v1

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Update titles of available/proposed sections

...

With the exception of the getImage query, all other queries return a comma separated value (CSV) file with results. The first line of the file contains the names of the columns in the response. Each subsequent line corresponds to one row from the TCIA database. The getImage query returns a zip of the images.

REST API Directory (Available as of 25-Apr-2013)

The query keys in the table below are the literal strings used as keys for key/value pairs to specify query parameters. After each key is an indication if the key is required for the query (R) or optional (O). Omitting optional keys will lead to responses that are more broad.

...

Query Name

Return Values

Query Key 1

Query Key 2

Query Key 3

Query Key 4

Query Key 5

Query Key 6

getCollectionValues

Set of all collection names

api_key (R)

 

 

 

 

 

getPatientStudy

Set of patient/study objects filtered by query keys

api_key (R)

collection (O)

patient_id (O)

study_instance_uid (O)

 


getSeries

Set of series objects filtered by query keys

api_key (R)

collection (O)

patient_id (O)

study_instance_uid (O)



getImage

Set of images in a zip file

api_key (R)

series_instance_uid (R)

 

 

 

 

REST API Directory (Proposed for Near Future, Subject to Discussion)

Query Name

Return Values

Query Key 1

Query Key 2

Query Key 3

Query Key 4

Query Key 5

Query Key 6

Query Key 7

getCollectionValues

Set of all collection names

api_key (R)

collection (O)

modality (O)

body_part (O)

manufacturer (O)

 

 

getModalityValues

Set of all modality values (CT, MR, ...) filtered by query keys

api_key (R)

collection (O)

modality (O)

body_part (O)

manufacturer (O)

 

 

getBodyPartValues

Set of all body part names filtered by query keys

api_key (R)

collection (O)

modality (O)

body_part (O)

manufacturer (O)

 

 

getManufacturerValues

Set of all manufacturer names filtered by query keys

api_key (R)

collection (O)

modality (O)

body_part (O)

manufacturer (O)

 

 

getPatientStudy

Set of patient/study objects filtered by query keys

api_key (R)

collection (O)

modality (O)

body_part (O)

manufacturer (O)

patient_id (O)

study_instance_uid (O)

getSeries

Set of series objects filtered by query keys

api_key (R)

collection (O)

modality (O)

body_part (O)

manufacturer (O)

patient_id (O)

study_instance_uid (O)

getImages

Set of images in a zip file

api_key (R)

series_instance_uid (R)

 

 

 

 

 

...