> ## Documentation Index
> Fetch the complete documentation index at: https://simplex.sh/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Search Drugs

> Fuzzy-search the supported fax-PA drug catalog (Wegovy, Ozempic, Zepbound, Mounjaro — all SKUs). Matches on either the stable `slug` (e.g. `wegovy_2.4mg_0.75ml_auto_injectors`) or the human-readable `full_name` (e.g. `Wegovy 2.4MG/0.75ML auto-injectors`). Use this to resolve a free-text drug query into the `slug` required by [Fill Prior Authorization](/payer-portal-api/fax/fill-pa).



## OpenAPI

````yaml GET /search_drugs
openapi: 3.0.1
info:
  title: Simplex API
  description: API for browser automation, web scraping, and workflow automation
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.simplex.sh
security:
  - bearerAuth: []
paths:
  /search_drugs:
    get:
      description: >-
        Fuzzy-search the supported fax-PA drug catalog (Wegovy, Ozempic,
        Zepbound, Mounjaro — all SKUs). Matches on either the stable `slug`
        (e.g. `wegovy_2.4mg_0.75ml_auto_injectors`) or the human-readable
        `full_name` (e.g. `Wegovy 2.4MG/0.75ML auto-injectors`). Use this to
        resolve a free-text drug query into the `slug` required by [Fill Prior
        Authorization](/payer-portal-api/fax/fill-pa).
      parameters:
        - name: query
          in: query
          required: true
          description: >-
            Partial or full drug name or slug to search for (e.g. "wegovy",
            "zepbound 5mg", "mounjaro auto-injectors",
            "wegovy_2.4mg_0.75ml_auto_injectors"). Matched case-insensitively
            against both slug and full_name, with exact > prefix > substring >
            token/fuzzy ranking.
          schema:
            type: string
        - name: limit
          in: query
          required: false
          description: Maximum number of matches to return (1-50). Defaults to 10.
          schema:
            type: integer
            minimum: 1
            maximum: 50
            default: 10
      responses:
        '200':
          description: Search drugs response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SearchDrugsResponse'
      x-codeSamples:
        - lang: python
          label: Search drugs
          source: |-
            import requests

            url = 'https://api.simplex.sh/search_drugs'
            headers = {
                'X-API-Key': 'your_api_key_here'
            }
            params = {
                'query': 'wegovy 1mg'
            }

            response = requests.get(url, headers=headers, params=params)
            result = response.json()
            for match in result['matches']:
                print(f"{match['slug']} — {match['full_name']}")
        - lang: curl
          label: Search drugs
          source: |-
            curl -X GET "https://api.simplex.sh/search_drugs?query=wegovy+1mg" \
              -H "X-API-Key: your_api_key_here"
components:
  schemas:
    SearchDrugsResponse:
      type: object
      properties:
        succeeded:
          type: boolean
          description: Whether the search executed successfully.
        query:
          type: string
          description: Echo of the query that was searched.
        matches:
          type: array
          description: >-
            Ranked list of matching drugs (best match first). Empty array if no
            match.
          items:
            type: object
            properties:
              slug:
                type: string
                description: >-
                  Stable machine-readable slug (e.g.
                  `wegovy_1mg_0.5ml_auto_injectors`). Pass this value as
                  `drug_slug` when calling Fill Prior Authorization.
              full_name:
                type: string
                description: >-
                  Human-readable drug name (e.g. `Wegovy 1MG/0.5ML
                  auto-injectors`).
              medication_strength:
                type: string
                description: >-
                  Canonical medication-strength string the backend uses on the
                  fax form.
            required:
              - slug
              - full_name
              - medication_strength
      required:
        - succeeded
        - query
        - matches
  securitySchemes:
    bearerAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: Simplex API Key

````