# Cancer.gov Disease API

**Canonical:** https://apis.io/apis/cancer-gov/cancer-gov-disease-api/  
**Provider:** Cancer.gov — https://apis.io/providers/cancer-gov/  
**Base URL:** https://clinicaltrialsapi.cancer.gov/api/v2  
**Documentation:** https://clinicaltrialsapi.cancer.gov/

Cancer.gov Disease API is one of 48 APIs that [Cancer.gov](https://apis.io/providers/cancer-gov/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Disease. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, rate-limit docs, and an API reference.

Hematopoietic, lymphoid neoplasms and solid tumor diseases

## Operations (21)

| Method | Path | Summary |
|---|---|---|
| PUT | `/rest/disease/{version}/update` | Update a disease entry |
| PUT | `/rest/disease/{version}/reset/{id}` | Reset a disease entry |
| POST | `/rest/disease/{version}/unhide/{id}` | Unhide a disease item |
| POST | `/rest/disease/{version}/publish` | Publish the specified disease entities into the associated production database |
| POST | `/rest/disease/{version}/hide/{id}` | Hide a disease item |
| POST | `/rest/disease/{version}/create` | Save a new disease entry |
| POST | `/rest/disease/versions/create` | Creates a new BETA version database |
| POST | `/rest/disease/reportability` | Returns the reportable year range of the supplied disease |
| GET | `/rest/disease/{version}` | Return a list of Disease entries |
| GET | `/rest/disease/{version}/status_summary` | Return a list of disease entries |
| GET | `/rest/disease/{version}/same_primary` | Indicate whether 2 morphologies (and diagnosis years) represent the same primary |
| GET | `/rest/disease/{version}/keywords` | Return a list of keywords contained in the disease entries |
| GET | `/rest/disease/{version}/id/{id}` | Return a single disease |
| GET | `/rest/disease/{version}/id/{id}/{year}` | Return a single disease with only year-based information for the passed year… |
| GET | `/rest/disease/{version}/changelog` | Return a list of Disease changelog entries |
| GET | `/rest/disease/versions` | Return a list of all versions of the disease database |
| GET | `/rest/disease/site_categories` | Return the complete list of site categories for use in the search API |
| GET | `/rest/disease/primary_site` | Return the list of ICDO2/ICDO3 primary site codes and labels |
| GET | `/rest/disease/primary_site/{code}` | Return the list of ICDO2/ICDO3 primary sites matching a code |
| DELETE | `/rest/disease/{version}/delete/{id}` | Delete a disease entry |
| DELETE | `/rest/disease/versions/delete` | Deletes an existing BETA version and all associated glossary entries |

## Machine-readable artifacts (21)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/cancer-gov/refs/heads/main/openapi/cancer-gov-disease-api-openapi.yml
- **Documentation** — https://api.seer.cancer.gov/docs
- **Portal** — https://api.seer.cancer.gov/
- **TermsOfService** — https://api.seer.cancer.gov/terms
- **RateLimits** — https://raw.githubusercontent.com/api-evangelist/cancer-gov/refs/heads/main/rate-limits/cancer-gov-rate-limits.yml
- **APIReference** — https://api.seer.cancer.gov/docs
- **Documentation** — https://modac.cancer.gov/swagger-ui/4.14.0/index.html
- **Portal** — https://modac.cancer.gov/
- **Documentation** — https://evs.nci.nih.gov/
- **Explorer** — https://evsexplore.semantics.cancer.gov/
- **WhitePaper** — https://evs.nci.nih.gov/ftp1/NCI_Metathesaurus/EVS%20Metathesaurus%20White%20Paper.pdf
- **APIReference** — https://api-evsrest.nci.nih.gov/swagger-ui/index.html
- **SourceCode** — https://github.com/NCIEVS/evsrestapi
- **TermsOfService** — https://evs.nci.nih.gov/ftp1/NCI_Thesaurus/ThesaurusTermsofUse.htm
- **SourceCode** — https://github.com/NCIOCPL/glossary-api
- **Documentation** — https://webapis.cancer.gov/glossary/v1/
- **SourceCode** — https://github.com/NCIOCPL/drug-dictionary-api
- **Documentation** — https://webapis.cancer.gov/drugdictionary/v1/
- **SourceCode** — https://github.com/NCIOCPL/sitewide-search-api
- **SourceCode** — https://github.com/NCIOCPL/bestbets-api
- **SourceCode** — https://github.com/NCIOCPL/r4r-api

## Other Cancer.gov APIs (12)

- [NCI Clinical Trials Search API](https://apis.io/apis/cancer-gov/clinical-trials-api/)
- [NCI Genomic Data Commons (GDC) API](https://apis.io/apis/cancer-gov/gdc-api/)
- [NCI Content Syndication Services](https://apis.io/apis/cancer-gov/syndication-services/)
- [Cancer.gov Diseases API](https://apis.io/apis/cancer-gov/cancer-gov-diseases-api/)
- [Cancer.gov Interventions API](https://apis.io/apis/cancer-gov/cancer-gov-interventions-api/)
- [Cancer.gov Terms API](https://apis.io/apis/cancer-gov/cancer-gov-terms-api/)
- [Cancer.gov Trials API](https://apis.io/apis/cancer-gov/cancer-gov-trials-api/)
- [Cancer.gov Application version endpoint API](https://apis.io/apis/cancer-gov/cancer-gov-application-version-endpoint-api/)
- [Cancer.gov Asset Details Controller API](https://apis.io/apis/cancer-gov/cancer-gov-asset-details-controller-api/)
- [Cancer.gov Autosuggest API](https://apis.io/apis/cancer-gov/cancer-gov-autosuggest-api/)
- [Cancer.gov Concept endpoints API](https://apis.io/apis/cancer-gov/cancer-gov-concept-endpoints-api/)
- [Cancer.gov Delete Collection Controller API](https://apis.io/apis/cancer-gov/cancer-gov-delete-collection-controller-api/)

## Tags

Disease

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/cancer-gov/cancer-gov-disease-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/cancer-gov/.