---
title: "Return a single disease with only year-based information for the passed year included"
method: GET
path: "/rest/disease/{version}/id/{id}/{year}"
tags: ["disease"]
---

# Return a single disease with only year-based information for the passed year included

`GET /rest/disease/{version}/id/{id}/{year}`

## Request

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

## Path parameters

- `version` string, required
- `id` string, required
- `year` string, required

## Response `200`

Success

- Disease: Disease entity
  - `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
  - `icdO3_morphology` string
  - `primary_site` SiteRange[]
    - `low` string
    - `high` string
  - `primary_site_text` string
  - `type` 'SOLID_TUMOR' | 'HEMATO' | 'NON_NEOPLASTIC'
  - `valid` YearRange
    - `start` integer
    - `end` integer
  - `obsolete_new_code` string[]
  - `reportable` YearRange[]
    - `start` integer
    - `end` integer
  - `abstractor_note` YearRangeString[]
    - `value` string
    - `start` integer
    - `end` integer
  - `treatment` YearRangeString[]
    - `value` string
    - `start` integer
    - `end` integer
  - `genetics` YearRangeString[]
    - `value` string
    - `start` integer
    - `end` integer
  - `alternate_name` YearRangeString[]
    - `value` string
    - `start` integer
    - `end` integer
  - `definition` YearRangeString[]
    - `value` string
    - `start` integer
    - `end` integer
  - `icdO2_morphology` string[]
  - `icdO1_morphology` string[]
  - `icd_10cm_code` DateRangeString[]
    - `value` string
    - `start` string
    - `end` string
  - `icd_10_code` string[]
  - `icd_9_code` string[]
  - `signs` YearRangeString[]
    - `value` string
    - `start` integer
    - `end` integer
  - `exams` YearRangeString[]
    - `value` string
    - `start` integer
    - `end` integer
  - `mortality` YearRangeString[]
    - `value` string
    - `start` integer
    - `end` integer
  - `source` DiseaseSource[]
    - `name` string
    - `section` string
    - `pages` string
  - `icdO3_effective` YearRange
    - `start` integer
    - `end` integer
  - `icdO2_effective` YearRange
    - `start` integer
    - `end` integer
  - `icdO1_effective` YearRange
    - `start` integer
    - `end` integer
  - `missing_primary_site_message` YearRangeString[]
    - `value` string
    - `start` integer
    - `end` integer
  - `grade` YearRangeInteger[]
    - `value` integer
    - `start` integer
    - `end` integer
  - `transform_to` YearRangeString[]
    - `value` string
    - `start` integer
    - `end` integer
  - `transform_to_text` YearRangeString[]
    - `value` string
    - `start` integer
    - `end` integer
  - `transform_from` YearRangeString[]
    - `value` string
    - `start` integer
    - `end` integer
  - `transform_from_text` YearRangeString[]
    - `value` string
    - `start` integer
    - `end` integer
  - `immunophenotype` YearRangeString[]
    - `value` string
    - `start` integer
    - `end` integer
  - `diagnosis_method` YearRangeString[]
    - `value` string
    - `start` integer
    - `end` integer
  - `module_id` YearRangeString[]
    - `value` string
    - `start` integer
    - `end` integer
  - `same_primary` YearRangeString[]
    - `value` string
    - `start` integer
    - `end` integer
  - `same_primary_text` YearRangeString[]
    - `value` string
    - `start` integer
    - `end` integer
  - `progression` YearRangeString[]
    - `value` string
    - `start` integer
    - `end` integer
  - `diagnostic_confirmation` YearRangeString[]
    - `value` string
    - `start` integer
    - `end` integer
  - `site_category` string
  - `biomarkers` YearRangeString[]
    - `value` string
    - `start` integer
    - `end` integer
  - `treatment_text` YearRangeString[]
    - `value` string
    - `start` integer
    - `end` integer
  - `recurrence` YearRangeString[]
    - `value` string
    - `start` integer
    - `end` integer
  - `metastatic` YearRangeString[]
    - `value` string
    - `start` integer
    - `end` integer

## Other responses

- `404`: Unknown disease

---

[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/2ab11538b3c7?raw)