---
title: "Return matching drugs"
method: GET
path: "/rest/ndc"
tags: ["ndc"]
---

# Return matching drugs

`GET /rest/ndc`

## Request

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

## Query parameters

- `q` string
- `has_seer_info` boolean
- `category` string[]
- `include_removed` boolean
- `page` integer
- `per_page` integer
- `order` 'ndc' | '-ndc' | 'date_added' | '-date_added' | 'date_modified' | '-date_modified' | 'proprietary_name' | '-proprietary_name'
- `added_since` string
- `modified_since` string
- `removed_since` string

## Response `200`

Success

- NdcProduct[]
  - `ndc` string
  - `type_name` string
  - `proprietary_name` string
  - `proprietary_name_suffix` string
  - `non_proprietary_name` string[]
  - `dosage_form_name` string
  - `route_name` string[]
  - `start_marketing_date` string
  - `end_marketing_date` string
  - `marketing_category_name` string
  - `application_number` string
  - `labeler_name` string
  - `substances` Substance[]
    - `name` string
    - `strength` string
    - `unit` string
  - `pharm_class` string[]
  - `dea_schedule` string
  - `packages` NdcPackage[]
    - `package` string
    - `description` string
    - `start_marketing_date` string
    - `end_marketing_date` string
  - `seer` NdcSeerInfo
    - `seer_rx_id` string
    - `categories` string[]
    - `subcategory` string
    - `major_drug_class` string
    - `minor_drug_class` string
    - `orphan_drug` boolean
    - `exclusive_oncologic_agent` boolean
    - `date_modified` string, date-time
  - `date_added` string, date-time
  - `date_modified` string, date-time
  - `date_removed` 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/2ab11538b3c7?raw)