Aristocles Pty Ltd Government Regulations API

openapi: 3.2.0
info:
  title: Aristocles Data Government Regulations 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: Government Regulations
  description: 'The Federal Register is the official daily journal of the United States government, containing proposed rules, final rules, presidential documents and public notices from every federal agency. This feed returns the most recent published documents with title, type, abstract, publication date and links to the official HTML and PDF versions. Compliance teams, legal tech products and regulatory-monitoring AI agents use it to detect rule changes the day they are published. Source: Source: Federal Register, Office of the Federal Register, U.S. National Archives and Records Administration.. Licence: Public Domain (U.S. Government work, 17 U.S.C. 105). Base path: /v1/data/united-states-federal-register-documents. Requires an API key (X-API-Key).'
paths:
  /v1/data/united-states-federal-register-documents:
    get:
      tags:
      - Government Regulations
      summary: List United States Federal Register Documents records
      description: 'List United States Federal Register Documents records with optional filters and pagination.


        **Source:** Source: Federal Register, Office of the Federal Register, U.S. National Archives and Records Administration. (Public Domain (U.S. Government work, 17 U.S.C. 105)).


        **Fields returned:**

        - `document_number` (str) — Unique Federal Register document number, e.g. 2026-01234

        - `title` (str) — Official title of the document

        - `document_type` (str) — Rule, Proposed Rule, Notice or Presidential Document

        - `abstract` (str) — Agency-written summary of the document

        - `publication_date` (date) — Date the document was published in the Federal Register

        - `html_url` (str) — Link to the official web version

        - `pdf_url` (str) — Link to the official PDF version


        **Example:** `GET /v1/data/united-states-federal-register-documents?limit=10&document_type=example`'
      operationId: list_endpoint_v1_data_united_states_federal_register_documents_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: document_type
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Rule, Proposed Rule, Notice or Presidential Document
          examples:
          - example
          title: Document Type
        description: Rule, Proposed Rule, Notice or Presidential Document
      - name: publication_date
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Date the document was published in the Federal Register
          examples:
          - '2026-01-01'
          title: Publication Date
        description: Date the document was published in the Federal Register
      - name: X-API-Key
        in: header
        required: true
        schema:
          type: string
          title: X-Api-Key
      responses:
        '200':
          description: A page of United States Federal Register Documents records with pagination metadata.
          content:
            application/json:
              schema: {}
              example:
                data:
                  items:
                  - document_number: example
                    title: example
                    document_type: example
                    abstract: example
                    publication_date: '2026-01-01'
                    html_url: example
                    pdf_url: example
                  total: 1
                  limit: 25
                  offset: 0
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/data/united-states-federal-register-documents/search:
    get:
      tags:
      - Government Regulations
      summary: Search United States Federal Register Documents by title
      description: 'Search United States Federal Register Documents records by `title` (partial, case-insensitive).


        **Example:** `GET /v1/data/united-states-federal-register-documents/search?q=exa`'
      operationId: search_endpoint_v1_data_united_states_federal_register_documents_search_get
      parameters:
      - name: q
        in: query
        required: true
        schema:
          type: string
          minLength: 2
          maxLength: 100
          description: Case-insensitive partial match on title.
          examples:
          - exa
          title: Q
        description: Case-insensitive partial match on title.
      - 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 Federal Register Documents records.
          content:
            application/json:
              schema: {}
              example:
                data:
                  items:
                  - document_number: example
                    title: example
                    document_type: example
                    abstract: example
                    publication_date: '2026-01-01'
                    html_url: example
                    pdf_url: example
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/data/united-states-federal-register-documents/{key}:
    get:
      tags:
      - Government Regulations
      summary: Get one United States Federal Register Documents record by document_number
      description: 'Fetch a single United States Federal Register Documents record by its `document_number`.


        **Example:** `GET /v1/data/united-states-federal-register-documents/example`'
      operationId: get_endpoint_v1_data_united_states_federal_register_documents__key__get
      parameters:
      - name: key
        in: path
        required: true
        schema:
          type: string
          description: The document_number value to look up (case-insensitive).
          examples:
          - example
          title: Key
        description: The document_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 Federal Register Documents record.
          content:
            application/json:
              schema: {}
              example:
                data:
                  document_number: example
                  title: example
                  document_type: example
                  abstract: example
                  publication_date: '2026-01-01'
                  html_url: example
                  pdf_url: example
        '404':
          content:
            application/json:
              example:
                error:
                  code: NOT_FOUND
                  message: No United States Federal Register Documents 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