...
This can be broken down as follows:
| BaseURL | https://services.cancerimagingarchive.net/services/v2 | The BaseURL includes the version number of this API (v2 in this example) |
|---|---|---|
| Resource | /TCIA | |
| QueryEndpoint | /query/getPatientStudy | |
| Query Parameters | Collection=TCGA-GBM PatientID=GBM-0123 | |
| Format | format=csv | Some APIs support CSV/HTML/XML/JSON, while others only support a single return type. Therefore this is required only in instances where multiple return types are supported. |
...
| Attribute | DICOM Tag | Description |
|---|---|---|
| NA | NA | Set of images in a zip file |
...
Testing the API
There are two RESTful servers provided by TCIA. A test system is loaded with a small set of known data to allow you to test your applications. The production system is configured to use the full TCIA database. The query format is the same for both systems. The base URLs are:
| Type | URL |
|---|---|
| Production | https://services.cancerimagingarchive.net/services/ |
v2/TCIA/query | |
| Test | https://services-test.cancerimagingarchive.net/services/ |
v2/TCIA/query |
The test server is loaded with this data:
Collections
| Collection |
|---|
| TCGA-KIRC |
| BREAST-DIAGNOSIS |
| TCGA-LGG |
| CT COLONOGRAPHY |
| LIDC-IDRI |
| TCGA-GBM |
| RIDER Lung PET-CT |
| TCGA-OV |
| Head-Neck Cetuximab |
| TCGA-PRAD |
| NSCLC Radiogenomics |
| TCGA-BRCA |
| RIDER PHANTOM MRI |
| TCGA-KIRP |
| RIDER PHANTOM PET-CT |
PatientStudy
| StudyInstanceUID | StudyDate | StudyDescription | AdmittingDiagnosesDescription | StudyID | PatientAge | PatientID | PatientName | PatientBirthDate | PatientSex | EthnicGroup | Collection | SeriesCount |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 1.3.6.1.4.1.14519.5.2.1.3344.4004.448358130266483790390581018240 | 1995-02-26 | CT Urogram with 3D | NULL | NULL | NULL | TCGA-CW-6088 | TCGA-CW-6088 | NULL | M | NULL | TCGA-KIRC | 3 |
| 1.3.6.1.4.1.14519.5.2.1.4792.2001.627577518886153755226383782162 | 2008-10-18 | Digital Right Mammogram Diagnostic | NULL | NULL | 029Y | BreastDx-01-0070 | NULL | NULL | F | NULL | BREAST-DIAGNOSIS | 5 |
| 1.3.6.1.4.1.14519.5.2.1.9203.4004.261688224366503947085525116820 | 1991-12-07 | FORFILE CD MR ABDOMEN | NULL | NULL | 072Y | TCGA-BP-5198 | TCGA-BP-5198 | NULL | M | NULL | TCGA-KIRC | 8 |
| 1.3.6.1.4.1.14519.5.2.1.5826.4003.897160909780395368971006445736 | 2002-12-19 | NR MRI BRAIN W/WO | NULL | NULL | 042Y | TCGA-FG-8186 | TCGA-FG-8186 | NULL | F | NULL | TCGA-LGG | 3 |
| 1.3.6.1.4.1.9328.50.4.10415 | 2000-01-01 | CT SCREENING VIRT COLONOSCOPY | NULL | 1 | 056Y | 1.3.6.1.4.1.9328.50.4.0011 | 1.3.6.1.4.1.9328.50.4.0011 | NULL | M | NULL | CT COLONOGRAPHY | 1 |
| 1.3.6.1.4.1.14519.5.2.1.6279.6001.627275201192675326215742498371 | 2000-01-01 | NULL | NULL | NULL | LIDC-IDRI-0077 | NULL | NULL | NULL | NULL | LIDC-IDRI | 1 | |
| 1.3.6.1.4.1.14519.5.2.1.7695.4001.218361089000532962354851713589 | 2001-06-06 | MSTEALTH | NULL | NULL | 030Y | TCGA-08-0355 | NULL | NULL | F | NULL | TCGA-GBM | 1 |
| 1.3.6.1.4.1.9328.50.17.171169503015012484365775373347971703543 | 2006-05-07 | NULL | NULL | NULL | 000Y | RIDER-1009463841 | 218236 | NULL | NULL | NULL | RIDER Lung PET-CT | 3 |
| 1.3.6.1.4.1.14519.5.2.1.7777.4007.207099377675611913572950287222 | 1992-09-01 | CT Chest with | NULL | NULL | 060Y | TCGA-24-1423 | TCGA-24-1423 | NULL | F | NULL | TCGA-OV | 2 |
| 1.3.6.1.4.1.14519.5.2.1.5099.8010.199920086920823171706454903251 | 1999-08-23 | Neck^HeadNeckPETCT | NULL | NULL | 000D | 0522c0001 | 0522c0001 | NULL | F | NULL | Head-Neck Cetuximab | 1 |
| 1.3.6.1.4.1.14519.5.2.1.4334.1501.111558925637778258818195924798 | 1991-07-17 | CT CHEST W CONTRAST | NULL | NULL | 062Y | GSM714069 | GSM714069 | NULL | 0 | NULL | NSCLC Radiogenomics | 2 |
| 1.3.6.1.4.1.14519.5.2.1.9203.4002.259172237572097188128951116391 | 2002-08-10 | NULL | NULL | NULL | 041Y | TCGA-AO-A03V | TCGA-AO-A03V | NULL | F | NULL | TCGA-BRCA | 1 |
| 1.3.12.2.1107.5.2.31.30165.30000008083115454467100000007 | 2008-08-31 | Physics^EFJ NCI | NULL | 1 | 018Y | ZZ083108C | ZZ RIDER 3 | 1990-01-01 | M | NULL | RIDER PHANTOM MRI | 7 |
| 1.3.6.1.4.1.14519.5.2.1.8421.4010.194703946276983777721182839151 | 2001-12-12 | MRI ABD W+WO CONT | NULL | NULL | 052Y | TCGA-B9-4115 | TCGA-B9-4115 | NULL | M | NULL | TCGA-KIRP | 1 |
| 1.2.840.113619.2.55.3.1602280607.497.1169961245.459 | 2007-01-27 | NULL | NULL | 2324 | 000Y | SNMCB04 | SNMCB04 | NULL | NULL | NULL | RIDER PHANTOM PET-CT | 1 |
| 1.3.6.1.4.1.14519.5.2.1.4792.2001.206552396038536458812411815856 | 2008-09-09 | MRI Right Breast with and without Contrast | NULL | NULL | NULL | BreastDx-01-0070 | NULL | NULL | F | NULL | BREAST-DIAGNOSIS | 2 |
Series
...
Click Here to see the test data that has been loaded on these test servers have the following test data