Aristocles Pty Ltd Medical Devices API

openapi: 3.2.0
info:
  title: Aristocles Data Medical Devices 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: Medical Devices
  description: 'The device identification records behind every medical device distributed in the United States, covering brand name, manufacturer, model and catalogue number, package counts, single-use and sterilisation flags, and imaging safety status. Hospital procurement tools, medical supply marketplaces and clinical AI agents use it to resolve a device label into a clean, structured product record. Source: Source: U.S. Food and Drug Administration, openFDA. Licence: U.S. Public Domain (openFDA). Base path: /v1/data/united-states-medical-device-catalogue. Requires an API key (X-API-Key).'
paths:
  /v1/data/united-states-medical-device-catalogue:
    get:
      tags:
      - Medical Devices
      summary: List United States Medical Device Catalogue records
      description: 'List United States Medical Device Catalogue records with optional filters and pagination.


        **Source:** Source: U.S. Food and Drug Administration, openFDA (U.S. Public Domain (openFDA)).


        **Fields returned:**

        - `device_record_key` (str) — Unique identifier for the device record

        - `brand_name` (str) — Brand name the device is marketed under

        - `company_name` (str) — Company that labels or manufactures the device

        - `device_description` (str) — Short description of what the device is

        - `model_number` (str) — Version or model number

        - `catalog_number` (str) — Manufacturer catalogue number

        - `package_count` (int) — Number of devices in the base package

        - `is_single_use` (bool) — True when the device is labelled single use

        - `is_kit` (bool) — True when the record describes a kit

        - `has_lot_or_batch_number` (bool) — True when units carry a lot or batch number

        - `has_expiration_date` (bool) — True when units carry an expiry date

        - `mri_safety` (str) — Magnetic resonance imaging safety status

        - `distribution_status` (str) — Whether the device is in commercial distribution

        - `published_date` (date) — Date the record was published


        **Example:** `GET /v1/data/united-states-medical-device-catalogue?limit=10&company_name=example`'
      operationId: list_endpoint_v1_data_united_states_medical_device_catalogue_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: company_name
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Company that labels or manufactures the device
          examples:
          - example
          title: Company Name
        description: Company that labels or manufactures the device
      - name: distribution_status
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Whether the device is in commercial distribution
          examples:
          - example
          title: Distribution Status
        description: Whether the device is in commercial distribution
      - name: is_single_use
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: True when the device is labelled single use
          examples:
          - 'True'
          title: Is Single Use
        description: True when the device is labelled single use
      - name: mri_safety
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Magnetic resonance imaging safety status
          examples:
          - example
          title: Mri Safety
        description: Magnetic resonance imaging safety status
      - name: X-API-Key
        in: header
        required: true
        schema:
          type: string
          title: X-Api-Key
      responses:
        '200':
          description: A page of United States Medical Device Catalogue records with pagination metadata.
          content:
            application/json:
              schema: {}
              example:
                data:
                  items:
                  - device_record_key: example
                    brand_name: example
                    company_name: example
                    device_description: example
                    model_number: example
                    catalog_number: example
                    package_count: 42
                    is_single_use: true
                    is_kit: true
                    has_lot_or_batch_number: true
                    has_expiration_date: true
                    mri_safety: example
                    distribution_status: example
                    published_date: '2026-01-01'
                  total: 1
                  limit: 25
                  offset: 0
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/data/united-states-medical-device-catalogue/search:
    get:
      tags:
      - Medical Devices
      summary: Search United States Medical Device Catalogue by brand_name
      description: 'Search United States Medical Device Catalogue records by `brand_name` (partial, case-insensitive).


        **Example:** `GET /v1/data/united-states-medical-device-catalogue/search?q=exa`'
      operationId: search_endpoint_v1_data_united_states_medical_device_catalogue_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 Medical Device Catalogue records.
          content:
            application/json:
              schema: {}
              example:
                data:
                  items:
                  - device_record_key: example
                    brand_name: example
                    company_name: example
                    device_description: example
                    model_number: example
                    catalog_number: example
                    package_count: 42
                    is_single_use: true
                    is_kit: true
                    has_lot_or_batch_number: true
                    has_expiration_date: true
                    mri_safety: example
                    distribution_status: example
                    published_date: '2026-01-01'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/data/united-states-medical-device-catalogue/{key}:
    get:
      tags:
      - Medical Devices
      summary: Get one United States Medical Device Catalogue record by device_record_key
      description: 'Fetch a single United States Medical Device Catalogue record by its `device_record_key`.


        **Example:** `GET /v1/data/united-states-medical-device-catalogue/example`'
      operationId: get_endpoint_v1_data_united_states_medical_device_catalogue__key__get
      parameters:
      - name: key
        in: path
        required: true
        schema:
          type: string
          description: The device_record_key value to look up (case-insensitive).
          examples:
          - example
          title: Key
        description: The device_record_key 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 Medical Device Catalogue record.
          content:
            application/json:
              schema: {}
              example:
                data:
                  device_record_key: example
                  brand_name: example
                  company_name: example
                  device_description: example
                  model_number: example
                  catalog_number: example
                  package_count: 42
                  is_single_use: true
                  is_kit: true
                  has_lot_or_batch_number: true
                  has_expiration_date: true
                  mri_safety: example
                  distribution_status: example
                  published_date: '2026-01-01'
        '404':
          content:
            application/json:
              example:
                error:
                  code: NOT_FOUND
                  message: No United States Medical Device Catalogue record for '...'.
          description: Not Found
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/data/united-states-medical-device-recalls:
    get:
      tags:
      - Medical Devices
      summary: List United States Medical Device Recalls records
      description: 'List United States Medical Device Recalls records with optional filters and pagination.


        **Source:** Source: openFDA, U.S. Food and Drug Administration. Not endorsed by the FDA. (Public domain (U.S. Government Work)).


        **Fields returned:**

        - `recall_number` (str) — FDA identifier for the recall event

        - `event_id` (str) — Identifier grouping related recall records

        - `status` (str) — Whether the recall is ongoing, completed or terminated

        - `classification` (str) — Risk class of the recall, Class I being most serious

        - `product_description` (str) — Description of the recalled device

        - `reason_for_recall` (str) — Why the device was recalled

        - `recalling_firm` (str) — Company conducting the recall

        - `firm_city` (str) — City of the recalling company

        - `firm_state` (str) — State of the recalling company

        - `firm_country` (str) — Country of the recalling company

        - `voluntary_or_mandated` (str) — Whether the recall was voluntary or FDA mandated

        - `distribution_pattern` (str) — Where the affected devices were distributed

        - `product_quantity` (str) — Quantity of product affected

        - `recall_initiation_date` (date) — Date the firm began the recall

        - `report_date` (date) — Date the recall was published by the FDA

        - `termination_date` (date) — Date the recall was terminated, if closed


        **Example:** `GET /v1/data/united-states-medical-device-recalls?limit=10&classification=example`'
      operationId: list_endpoint_v1_data_united_states_medical_device_recalls_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: classification
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Risk class of the recall, Class I being most serious
          examples:
          - example
          title: Classification
        description: Risk class of the recall, Class I being most serious
      - name: status
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Whether the recall is ongoing, completed or terminated
          examples:
          - example
          title: Status
        description: Whether the recall is ongoing, completed or terminated
      - name: recalling_firm
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Company conducting the recall
          examples:
          - example
          title: Recalling Firm
        description: Company conducting the recall
      - name: firm_state
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: State of the recalling company
          examples:
          - example
          title: Firm State
        description: State of the recalling company
      - name: firm_country
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Country of the recalling company
          examples:
          - example
          title: Firm Country
        description: Country of the recalling company
      - name: report_date
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Date the recall was published by the FDA
          examples:
          - '2026-01-01'
          title: Report Date
        description: Date the recall was published by the FDA
      - name: X-API-Key
        in: header
        required: true
        schema:
          type: string
          title: X-Api-Key
      responses:
        '200':
          description: A page of United States Medical Device Recalls records with pagination metadata.
          content:
            application/json:
              schema: {}
              example:
                data:
                  items:
                  - recall_number: example
                    event_id: example
                    status: example
                    classification: example
                    product_description: example
                    reason_for_recall: example
                    recalling_firm: example
                    firm_city: example
                    firm_state: example
                    firm_country: example
                    voluntary_or_mandated: example
                    distribution_pattern: example
                    product_quantity: example
                    recall_initiation_date: '2026-01-01'
                    report_date: '2026-01-01'
                    termination_date: '2026-01-01'
                  total: 1
                  limit: 25
                  offset: 0
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/data/united-states-medical-device-recalls/search:
    get:
      tags:
      - Medical Devices
      summary: Search United States Medical Device Recalls by product_description
      description: 'Search United States Medical Device Recalls records by `product_description` (partial, case-insensitive).


        **Example:** `GET /v1/data/united-states-medical-device-recalls/search?q=exa`'
      operationId: search_endpoint_v1_data_united_states_medical_device_recalls_search_get
      parameters:
      - name: q
        in: query
        required: true
        schema:
          type: string
          minLength: 2
          maxLength: 100
          description: Case-insensitive partial match on product_description.
          examples:
          - exa
          title: Q
        description: Case-insensitive partial match on product_description.
      - 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 Medical Device Recalls records.
          content:
            application/json:
              schema: {}
              example:
                data:
                  items:
                  - recall_number: example
                    event_id: example
                    status: example
                    classification: example
                    product_description: example
                    reason_for_recall: example
                    recalling_firm: example
                    firm_city: example
                    firm_state: example
                    firm_country: example
                    voluntary_or_mandated: example
                    distribution_pattern: example
                    product_quantity: example
                    recall_initiation_date: '2026-01-01'
                    report_date: '2026-01-01'
                    termination_date: '2026-01-01'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/data/united-states-medical-device-recalls/{key}:
    get:
      tags:
      - Medical Devices
      summary: Get one United States Medical Device Recalls record by recall_number
      description: 'Fetch a single United States Medical Device Recalls record by its `recall_number`.


        **Example:** `GET /v1/data/united-states-medical-device-recalls/example`'
      operationId: get_endpoint_v1_data_united_states_medical_device_recalls__key__get
      parameters:
      - name: key
        in: path
        required: true
        schema:
          type: string
          description: The recall_number value to look up (case-insensitive).
          examples:
          - example
          title: Key
        description: The recall_number 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 Medical Device Recalls record.
          content:
            application/json:
              schema: {}
              example:
                data:
                  recall_number: example
                  event_id: example
                  status: example
                  classification: example
                  product_description: example
                  reason_for_recall: example
                  recalling_firm: example
                  firm_city: example
                  firm_state: example
                  firm_country: example
                  voluntary_or_mandated: example
                  distribution_pattern: example
                  product_quantity: example
                  recall_initiation_date: '2026-01-01'
                  report_date: '2026-01-01'
                  termination_date: '2026-01-01'
        '404':
          content:
            application/json:
              example:
                error:
                  code: NOT_FOUND
                  message: No United States Medical Device Recalls 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