---
title: "Return a list of Disease entries"
method: GET
path: "/rest/disease/{version}"
tags: ["disease"]
---

# Return a list of Disease entries

`GET /rest/disease/{version}`

## Request

- Base URL: `https://api.seer.cancer.gov`
- URL: `https://api.seer.cancer.gov/rest/disease/{version}`
- Auth: API key in header `X-SEERAPI-Key`
- TypeScript: <https://skmtc.dev/cancer/apis/seer-api/docs/rest/disease/:version/get.ts> (a function with typed inputs; its response is checked against the schema)

This API call returns both Hematopoietic and Solid Tumor data. The Solid Tumor data, however, is being provided as a preview only. In order to retrieve data that is ready for use in your systems, please make sure to include the HEMATO type parameter when retrieving disease data. **If you do not provide a parameter, you will be retrieving data for both Hematopoietic and Solid Tumors.**

## Path parameters

- `version` string, required

## Query parameters

- `q` string
- `status` string[]
- `assigned_to` string
- `site_category` string[]
- `type` 'SOLID_TUMOR' | 'HEMATO' | 'NON_NEOPLASTIC'
- `modified_from` string
- `modified_to` string
- `published_from` string
- `published_to` string
- `been_published` boolean
- `hidden` boolean
- `mode` 'AND' | 'OR'
- `count` integer
- `offset` integer
- `order` 'name' | '-name' | 'status' | '-status' | 'assigned_to' | '-assigned_to' | 'last_modified' | '-last_modified' | 'type' | '-type' | 'site_category' | '-site_category' | 'icdO3_morphology' | '-icdO3_morphology'
- `output_type` 'MIN' | 'PARTIAL' | 'FULL'
- `glossary` boolean

## Response `200`

Success

- PublishableSearchResults
  - `terms` string[]
  - `total` integer
  - `count` integer
  - `offset` integer
  - `max_score` number, double
  - `order` string
  - `results` PublishableEntity[]
    - `id` string
    - `name` string
    - `version` string
    - `hidden` boolean
    - `status` string
    - `assigned_to` string
    - `first_published` string, date-time
    - `last_modified` string, date-time
    - `fingerprint` string
    - `note` string
    - `field_notes` object
    - `score` number, double
    - `glossary` ApiKeywordMatch[]
      - `id` string
      - `name` string
      - `keyword` string
      - `category` string[]
      - `start` integer
      - `end` integer

## Other responses

- `400`: Invalid input

---

[API](https://skmtc.dev/cancer/apis/seer-api.md) - [All operations](https://skmtc.dev/cancer/apis/seer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cancer/apis/seer-api/revisions/f6634f7497ad?raw)