Aristocles Pty Ltd PBS Drug Pricing API

openapi: 3.2.0
info:
  title: Aristocles Data PBS Drug Pricing 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: PBS Drug Pricing
  description: Australian Pharmaceutical Benefits Scheme pricing for 14,000+ medications. Returns government benefit price, patient copayment (general and concessional), and safety net thresholds. Updated monthly.
paths:
  /v1/pbs/search:
    get:
      tags:
      - PBS Drug Pricing
      summary: Search PBS drugs
      description: 'Search PBS-listed drugs by generic or brand name.


        Returns PBS benefit price, patient copayment cost (general and concessional),

        pack size, repeats, and therapeutic group for each matching listing.'
      operationId: search_drugs_endpoint_v1_pbs_search_get
      parameters:
      - name: q
        in: query
        required: true
        schema:
          type: string
          minLength: 2
          maxLength: 200
          description: Drug or brand name to search
          title: Q
        description: Drug or brand name to search
        example: metformin
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 100
          minimum: 1
          description: Max results
          default: 20
          title: Limit
        description: Max results
      - name: X-API-Key
        in: header
        required: true
        schema:
          type: string
          title: X-Api-Key
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/pbs/copayments:
    get:
      tags:
      - PBS Drug Pricing
      summary: Get patient copayment thresholds
      description: 'Current PBS patient copayment thresholds.


        General patients pay the lesser of the PBS benefit price or the general copayment cap.

        Concession card holders pay the concessional rate regardless of benefit price.

        Safety net thresholds trigger once annual spending exceeds the limit.'
      operationId: copayments_endpoint_v1_pbs_copayments_get
      parameters:
      - name: X-API-Key
        in: header
        required: true
        schema:
          type: string
          title: X-Api-Key
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/pbs/categories:
    get:
      tags:
      - PBS Drug Pricing
      summary: List therapeutic groups
      description: List all PBS therapeutic groups with drug counts.
      operationId: list_categories_endpoint_v1_pbs_categories_get
      parameters:
      - name: X-API-Key
        in: header
        required: true
        schema:
          type: string
          title: X-Api-Key
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/pbs/categories/{therapeutic_group}:
    get:
      tags:
      - PBS Drug Pricing
      summary: Get drugs in a therapeutic group
      description: Get all PBS-listed drugs in a therapeutic group.
      operationId: category_drugs_endpoint_v1_pbs_categories__therapeutic_group__get
      parameters:
      - name: therapeutic_group
        in: path
        required: true
        schema:
          type: string
          title: Therapeutic Group
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 200
          minimum: 1
          description: Max results
          default: 50
          title: Limit
        description: Max results
      - name: X-API-Key
        in: header
        required: true
        schema:
          type: string
          title: X-Api-Key
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/pbs/{drug_name}:
    get:
      tags:
      - PBS Drug Pricing
      summary: Get drug pricing by name
      description: 'Get full PBS pricing detail for a drug — originator brand vs generics, all forms and pack sizes.


        Patient cost is calculated automatically:

        - General patients pay min(PBS benefit price, general copayment cap)

        - Concessional patients pay the concessional rate'
      operationId: get_drug_endpoint_v1_pbs__drug_name__get
      parameters:
      - name: drug_name
        in: path
        required: true
        schema:
          type: string
          title: Drug Name
      - name: X-API-Key
        in: header
        required: true
        schema:
          type: string
          title: X-Api-Key
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '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