---
title: "Return a single surgery table"
method: GET
path: "/rest/surgery/{year}/table"
tags: ["surgery"]
---

# Return a single surgery table

`GET /rest/surgery/{year}/table`

## Request

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

Either title or a site/histology combination must be supplied.

## Path parameters

- `year` string, required

## Query parameters

- `title` string
- `site` string
- `hist` string

## Response `200`

Success

- SurgeryTable
  - `title` string
  - `site_inclusions` string
  - `hist_exclusions` string
  - `hist_inclusions` string
  - `pre_note` string
  - `post_note` string
  - `row` SurgeryRow[]
    - `code` string
    - `description` string
    - `level` integer
    - `line_break` boolean

## Other responses

- `400`: Either title or site/histology must be supplied

---

[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)