---
title: "Typeahead suggest (brand/ingredient groups). No packages on hits."
method: GET
path: "/v1/drugs/search"
tags: ["Index"]
---

# Typeahead suggest (brand/ingredient groups). No packages on hits.

`GET /v1/drugs/search`

## Request

- Base URL: `https://api.pillwise.dev`
- URL: `https://api.pillwise.dev/v1/drugs/search`
- Auth: HTTP bearer

Suggest hits are what a member picks, in order: the medicine named exactly, then its main forms ("Gabapentin capsule"), brands and other ingredients, combinations, salts and single products; within each, the most widely sold first. Label names that are only the generic name ("Sertraline HCl") are the medicine itself. Everyday names ("vitamin D3", "NPH insulin") and brands still said after leaving the market ("Zofran") find the medicine; such a brand hit shows the name typed with the ingredient as its subtitle.

## Query parameters

- `q` string, required
- `jurisdiction` string
- `limit` integer
- `cabinet_only` boolean
- `intent` 'suggest' | 'sku'
- `as_of` string
- `graph_version` string

## Response `200`

Suggest hits. Empty hits is 200, not 404.

- SearchResponse
  - `hits` SearchHit[], required
    - `id` string, required
    - `display_name` string, required
    - `subtitle` string
    - `matched_term` string, required
    - `match_kind` 'preferred' | 'synonym' | 'brand' | 'proprietary' | 'identifier', required
    - `pick_level` 'brand' | 'ingredient' | 'clinical_drug' | 'packaged_product'
    - `presentation_count` integer
    - `tty` string
    - `rxcui` string
    - `form` string: On a suggest hit, the form the member's words chose ("nicotine patch" -> `patch`): pass it as `?form=` to form-options or presentations. On `intent=sku` hits, the drug's form value.
    - `form_label` string
    - `strength` string
    - `strength_label` string
    - `route` string
    - `cabinet_eligible` boolean, required
    - `form_options` FormOptions: Each choice has a `value` to send back (`?form=`, Cabinet `answers.form` / `answers.strength`) and a `label` to show. Only products on the US market are listed (a package or a current label). Forms come most sold first, with vials, packs and clinic-only forms last; strengths follow their form, then read by amount, and name the forms they come in.
      - `forms` FormChoice[]
        - `value` string, required
        - `label` string, required
        - `group` 'tablet' | 'capsule' | 'oral_liquid' | 'oral_other' | 'mouth' | 'skin' | 'eye' | 'ear' | 'nose' | 'inhaled' | 'patch' | 'injection' | 'rectal' | 'vaginal' | 'implant' | 'clinic' | 'pack' | 'other', required: What kind of thing it is, for tailoring the next questions.
        - `dose_unit` string, required: What one dose is counted in.
        - `route` string
      - `strengths` StrengthChoice[]
        - `value` string, required
        - `label` string, required
        - `forms` string[]: The form values this strength comes in, so a client holding every form's strengths can narrow them without another call.
      - `routes` Choice[]
        - `value` string, required
        - `label` string, required
      - `packages` object[]
        - `ndc_raw` string
        - `ndc11` string
        - `display` string
        - `description` string
    - `codes` object
      - `rxcui` string
      - `ndc11` string[]
      - `unii` string[]
      - `spl_set_id` string
      - `application_number` string
      - `te_code` string
  - `coverage` 'cpc_current', required
  - `graph_version` string, required
  - `as_of` string, date-time, required
  - `jurisdiction` string, required
  - `freshness` string, required

## Other responses

- `401`: missing_key or bad_key
- `402`: quota_exceeded (included and bought blocks used up, grace elapsed) or subscription_lapsed (the paid period ended and did not renew)
- `403`: tenant_disabled or forbidden_scope
- `410`: Requested snapshot is not retained (gone_graph)
- `429`: rate_limited (process safety fuse)

---

[API](https://skmtc.dev/pillwise/apis/pillwise-api.md) · [All operations](https://skmtc.dev/pillwise/apis/pillwise-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pillwise/apis/pillwise-api/revisions/2c2ca705f9ef?raw)