Aristocles Pty Ltd Drug Products API

openapi: 3.2.0
info:
  title: Aristocles Data Drug Products API
  description: 'Four Australian data APIs on one key — subscriptions, trade pricing, PBS drugs, and rental prices.


    ---


    ## Quick start


    **1. Get your API key** — register in one request:

    ```

    POST /v1/auth/register

    {"email": "you@example.com", "name": "Your Name"}

    ```

    Copy the `api_key` from the response.


    **2. Authenticate** — add your key to every request as a header:

    ```

    X-API-Key: ar_live_xxxxxxxxxxxx

    ```


    **3. Run the discovery endpoint** — returns all available slugs, example calls, and your account limits:

    ```

    GET /v1/discovery

    ```


    **4. Make your first call:**

    ```

    GET /v1/prices/netflix?country=AU

    GET /v1/trades/electrician/prices?state=NSW&country=AU

    GET /v1/pbs/metformin

    GET /v1/rental/VIC/Richmond

    ```


    ---


    ## Four data domains


    | Domain | Base path | What it covers |

    |---|---|---|

    | **Subscription Pricing** | `/v1/prices`, `/v1/services` | 50+ SaaS & streaming services: Netflix, Spotify, Adobe, etc. |

    | **Contractor Trades** | `/v1/trades` | Plumbers, electricians, painters across AU, US, UK, CA, NZ |

    | **PBS Drug Pricing** | `/v1/pbs` | 14,000+ medications on Australia''s Pharmaceutical Benefits Scheme |

    | **Rental Market** | `/v1/rental` | Median weekly rent by suburb and postcode across Australia |

    | **RBA Economic Data** | `/v1/rba` | Cash rate, AUD FX rates, CPI inflation, mortgage rates, credit aggregates |


    ---


    ## MCP Server


    All four data domains are also available as MCP tools at:

    ```

    https://api.aristocles.com.au/mcp/

    ```

    Connect any MCP-compatible AI agent (Claude, GPT, Gemini) to get structured data without writing API calls.'
  version: 2.1.0
tags:
- name: Drug Products
  description: 'The national directory of finished and unfinished drug products, listing each product''s identifying code, brand and generic names, dosage form, labeller and marketing category. It is reference data about products, not about patients or prescriptions. Health-tech products, pharmacy tools and clinical AI agents use it to resolve a drug name to a canonical product record. Source: Source: openFDA, U.S. Food and Drug Administration. Not for clinical use.. Licence: Public domain (CC0, US Government work). Base path: /v1/data/united-states-drug-product-directory. Requires an API key (X-API-Key).'
paths:
  /v1/data/united-states-drug-product-directory:
    get:
      tags:
      - Drug Products
      summary: List United States Drug Product Directory records
      description: 'List United States Drug Product Directory records with optional filters and pagination.


        **Source:** Source: openFDA, U.S. Food and Drug Administration. Not for clinical use. (Public domain (CC0, US Government work)).


        **Fields returned:**

        - `product_ndc` (str) — National drug code identifying the labeller and product

        - `brand_name` (str) — Marketed brand or proprietary name

        - `generic_name` (str) — Generic or non-proprietary name of the active ingredients

        - `labeler_name` (str) — Company that labels and markets the product

        - `dosage_form` (str) — Physical form, for example tablet, injection or cream

        - `product_type` (str) — Whether the product is prescription, over-the-counter or another category

        - `marketing_category` (str) — Regulatory pathway under which the product is marketed

        - `dea_schedule` (str) — Controlled substance schedule where one applies

        - `marketing_start_date` (str) — Date marketing began, formatted as YYYYMMDD

        - `finished` (bool) — True for finished dosage products, false for bulk ingredients


        **Example:** `GET /v1/data/united-states-drug-product-directory?limit=10&labeler_name=example`'
      operationId: list_endpoint_v1_data_united_states_drug_product_directory_get
      parameters:
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 100
          minimum: 1
          description: Max records to return (1-100).
          default: 25
          title: Limit
        description: Max records to return (1-100).
      - name: offset
        in: query
        required: false
        schema:
          type: integer
          minimum: 0
          description: Records to skip, for pagination.
          default: 0
          title: Offset
        description: Records to skip, for pagination.
      - name: labeler_name
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Company that labels and markets the product
          examples:
          - example
          title: Labeler Name
        description: Company that labels and markets the product
      - name: dosage_form
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Physical form, for example tablet, injection or cream
          examples:
          - example
          title: Dosage Form
        description: Physical form, for example tablet, injection or cream
      - name: product_type
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Whether the product is prescription, over-the-counter or another category
          examples:
          - example
          title: Product Type
        description: Whether the product is prescription, over-the-counter or another category
      - name: marketing_category
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Regulatory pathway under which the product is marketed
          examples:
          - example
          title: Marketing Category
        description: Regulatory pathway under which the product is marketed
      - name: dea_schedule
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Controlled substance schedule where one applies
          examples:
          - example
          title: Dea Schedule
        description: Controlled substance schedule where one applies
      - name: X-API-Key
        in: header
        required: true
        schema:
          type: string
          title: X-Api-Key
      responses:
        '200':
          description: A page of United States Drug Product Directory records with pagination metadata.
          content:
            application/json:
              schema: {}
              example:
                data:
                  items:
                  - product_ndc: example
                    brand_name: example
                    generic_name: example
                    labeler_name: example
                    dosage_form: example
                    product_type: example
                    marketing_category: example
                    dea_schedule: example
                    marketing_start_date: example
                    finished: true
                  total: 1
                  limit: 25
                  offset: 0
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/data/united-states-drug-product-directory/search:
    get:
      tags:
      - Drug Products
      summary: Search United States Drug Product Directory by brand_name
      description: 'Search United States Drug Product Directory records by `brand_name` (partial, case-insensitive).


        **Example:** `GET /v1/data/united-states-drug-product-directory/search?q=exa`'
      operationId: search_endpoint_v1_data_united_states_drug_product_directory_search_get
      parameters:
      - name: q
        in: query
        required: true
        schema:
          type: string
          minLength: 2
          maxLength: 100
          description: Case-insensitive partial match on brand_name.
          examples:
          - exa
          title: Q
        description: Case-insensitive partial match on brand_name.
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 100
          minimum: 1
          description: Max records to return (1-100).
          default: 25
          title: Limit
        description: Max records to return (1-100).
      - name: X-API-Key
        in: header
        required: true
        schema:
          type: string
          title: X-Api-Key
      responses:
        '200':
          description: Matching United States Drug Product Directory records.
          content:
            application/json:
              schema: {}
              example:
                data:
                  items:
                  - product_ndc: example
                    brand_name: example
                    generic_name: example
                    labeler_name: example
                    dosage_form: example
                    product_type: example
                    marketing_category: example
                    dea_schedule: example
                    marketing_start_date: example
                    finished: true
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/data/united-states-drug-product-directory/{key}:
    get:
      tags:
      - Drug Products
      summary: Get one United States Drug Product Directory record by product_ndc
      description: 'Fetch a single United States Drug Product Directory record by its `product_ndc`.


        **Example:** `GET /v1/data/united-states-drug-product-directory/example`'
      operationId: get_endpoint_v1_data_united_states_drug_product_directory__key__get
      parameters:
      - name: key
        in: path
        required: true
        schema:
          type: string
          description: The product_ndc value to look up (case-insensitive).
          examples:
          - example
          title: Key
        description: The product_ndc value to look up (case-insensitive).
      - name: X-API-Key
        in: header
        required: true
        schema:
          type: string
          title: X-Api-Key
      responses:
        '200':
          description: A single United States Drug Product Directory record.
          content:
            application/json:
              schema: {}
              example:
                data:
                  product_ndc: example
                  brand_name: example
                  generic_name: example
                  labeler_name: example
                  dosage_form: example
                  product_type: example
                  marketing_category: example
                  dea_schedule: example
                  marketing_start_date: example
                  finished: true
        '404':
          content:
            application/json:
              example:
                error:
                  code: NOT_FOUND
                  message: No United States Drug Product Directory record for '...'.
          description: Not Found
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError