---
title: "Return matching procedures"
method: GET
path: "/rest/hcpcs"
tags: ["hcpcs"]
---

# Return matching procedures

`GET /rest/hcpcs`

## Request

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

## Query parameters

- `q` string
- `category` string[]
- `page` integer
- `per_page` integer
- `order` 'hcpcs_code' | '-hcpcs_code' | 'date_added' | '-date_added' | 'date_modified' | '-date_modified'
- `added_since` string
- `modified_since` string

## Response `200`

Success

- HcpcsProcedure[]
  - `hcpcs_code` string
  - `generic_name` string
  - `description` string
  - `brand_names` string[]
  - `strength` string
  - `fda_approval_year` string
  - `fda_discontinuation_year` string
  - `cms_approval_date` string
  - `cms_discontinuation_date` string
  - `categories` string[]
  - `major_drug_class` string
  - `minor_drug_class` string
  - `oral` boolean
  - `date_added` string, date-time
  - `date_modified` string, date-time
  - `score` number, double

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