Aristocles Pty Ltd Electric Vehicles API

openapi: 3.2.0
info:
  title: Aristocles Data Electric Vehicles 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: Electric Vehicles
  description: 'A vehicle-level register of all battery electric and plug-in hybrid vehicles currently registered with the Washington State Department of Licensing, including make, model, model year, electric range, county, city and electric utility. EV makers, charging network planners, utilities and market analysts use it to track adoption and plan infrastructure. Source: Washington State Department of Licensing, Electric Vehicle Population Data, via data.wa.gov. Licence: Washington State open data (data.wa.gov terms of use). Base path: /v1/data/washington-state-electric-vehicle-registrations. Requires an API key (X-API-Key).'
paths:
  /v1/data/washington-state-electric-vehicle-registrations:
    get:
      tags:
      - Electric Vehicles
      summary: List Washington State Electric Vehicle Registrations records
      description: 'List Washington State Electric Vehicle Registrations records with optional filters and pagination.


        **Source:** Washington State Department of Licensing, Electric Vehicle Population Data, via data.wa.gov (Washington State open data (data.wa.gov terms of use)).


        **Fields returned:**

        - `vin_prefix` (str) — First 10 characters of the vehicle identification number (not a full VIN)

        - `county` (str) — County where the vehicle is registered

        - `city` (str) — City where the vehicle is registered

        - `state` (str) — State of registration

        - `postal_code` (str) — Postal code of registration area

        - `model_year` (int) — Vehicle model year

        - `make` (str) — Vehicle manufacturer

        - `model` (str) — Vehicle model

        - `electric_vehicle_type` (str) — Battery Electric Vehicle (BEV) or Plug-in Hybrid Electric Vehicle (PHEV)

        - `clean_fuel_eligibility` (str) — Clean Alternative Fuel Vehicle eligibility status

        - `electric_range` (int) — Rated all-electric range in miles (0 where not yet researched)

        - `base_msrp` (float) — Lowest manufacturer suggested retail price for the model (0 where unknown)

        - `legislative_district` (int) — Washington State legislative district

        - `dol_vehicle_id` (str) — Unique Department of Licensing vehicle record identifier

        - `vehicle_location` (str) — Approximate centre point of the postal code as a WKT POINT

        - `electric_utility` (str) — Electric utility serving the registration area

        - `census_tract` (str) — 2020 census tract identifier


        **Example:** `GET /v1/data/washington-state-electric-vehicle-registrations?limit=10&make=example`'
      operationId: list_endpoint_v1_data_washington_state_electric_vehicle_registrations_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: make
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Vehicle manufacturer
          examples:
          - example
          title: Make
        description: Vehicle manufacturer
      - name: model_year
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Vehicle model year
          examples:
          - '42'
          title: Model Year
        description: Vehicle model year
      - name: county
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: County where the vehicle is registered
          examples:
          - example
          title: County
        description: County where the vehicle is registered
      - name: electric_vehicle_type
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Battery Electric Vehicle (BEV) or Plug-in Hybrid Electric Vehicle (PHEV)
          examples:
          - example
          title: Electric Vehicle Type
        description: Battery Electric Vehicle (BEV) or Plug-in Hybrid Electric Vehicle (PHEV)
      - name: electric_utility
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Electric utility serving the registration area
          examples:
          - example
          title: Electric Utility
        description: Electric utility serving the registration area
      - name: X-API-Key
        in: header
        required: true
        schema:
          type: string
          title: X-Api-Key
      responses:
        '200':
          description: A page of Washington State Electric Vehicle Registrations records with pagination metadata.
          content:
            application/json:
              schema: {}
              example:
                data:
                  items:
                  - vin_prefix: example
                    county: example
                    city: example
                    state: example
                    postal_code: example
                    model_year: 42
                    make: example
                    model: example
                    electric_vehicle_type: example
                    clean_fuel_eligibility: example
                    electric_range: 42
                    base_msrp: 4.2
                    legislative_district: 42
                    dol_vehicle_id: example
                    vehicle_location: example
                    electric_utility: example
                    census_tract: example
                  total: 1
                  limit: 25
                  offset: 0
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/data/washington-state-electric-vehicle-registrations/search:
    get:
      tags:
      - Electric Vehicles
      summary: Search Washington State Electric Vehicle Registrations by model
      description: 'Search Washington State Electric Vehicle Registrations records by `model` (partial, case-insensitive).


        **Example:** `GET /v1/data/washington-state-electric-vehicle-registrations/search?q=exa`'
      operationId: search_endpoint_v1_data_washington_state_electric_vehicle_registrations_search_get
      parameters:
      - name: q
        in: query
        required: true
        schema:
          type: string
          minLength: 2
          maxLength: 100
          description: Case-insensitive partial match on model.
          examples:
          - exa
          title: Q
        description: Case-insensitive partial match on model.
      - 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 Washington State Electric Vehicle Registrations records.
          content:
            application/json:
              schema: {}
              example:
                data:
                  items:
                  - vin_prefix: example
                    county: example
                    city: example
                    state: example
                    postal_code: example
                    model_year: 42
                    make: example
                    model: example
                    electric_vehicle_type: example
                    clean_fuel_eligibility: example
                    electric_range: 42
                    base_msrp: 4.2
                    legislative_district: 42
                    dol_vehicle_id: example
                    vehicle_location: example
                    electric_utility: example
                    census_tract: example
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/data/washington-state-electric-vehicle-registrations/{key}:
    get:
      tags:
      - Electric Vehicles
      summary: Get one Washington State Electric Vehicle Registrations record by dol_vehicle_id
      description: 'Fetch a single Washington State Electric Vehicle Registrations record by its `dol_vehicle_id`.


        **Example:** `GET /v1/data/washington-state-electric-vehicle-registrations/example`'
      operationId: get_endpoint_v1_data_washington_state_electric_vehicle_registrations__key__get
      parameters:
      - name: key
        in: path
        required: true
        schema:
          type: string
          description: The dol_vehicle_id value to look up (case-insensitive).
          examples:
          - example
          title: Key
        description: The dol_vehicle_id 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 Washington State Electric Vehicle Registrations record.
          content:
            application/json:
              schema: {}
              example:
                data:
                  vin_prefix: example
                  county: example
                  city: example
                  state: example
                  postal_code: example
                  model_year: 42
                  make: example
                  model: example
                  electric_vehicle_type: example
                  clean_fuel_eligibility: example
                  electric_range: 42
                  base_msrp: 4.2
                  legislative_district: 42
                  dol_vehicle_id: example
                  vehicle_location: example
                  electric_utility: example
                  census_tract: example
        '404':
          content:
            application/json:
              example:
                error:
                  code: NOT_FOUND
                  message: No Washington State Electric Vehicle Registrations 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