Aristocles Pty Ltd Transportation API

openapi: 3.2.0
info:
  title: Aristocles Data Transportation 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: Transportation
  description: 'Contains location, type, and identifier data for tens of thousands of airports globally. Essential for travel tech startups, logistics companies, and any AI agent planning travel or analyzing transportation networks. Source: Data provided by OurAirports. Licence: Public Domain. Base path: /v1/data/global-airport-locations. Requires an API key (X-API-Key).'
paths:
  /v1/data/global-airport-locations:
    get:
      tags:
      - Transportation
      summary: List Global Airport Locations records
      description: 'List Global Airport Locations records with optional filters and pagination.


        **Source:** Data provided by OurAirports (Public Domain).


        **Fields returned:**

        - `iata_code` (str) — 3-letter IATA airport code.

        - `name` (str) — Official name of the airport.

        - `airport_type` (str) — Type of airport (e.g., ''large_airport'', ''heliport'').

        - `latitude` (float) — The latitude of the airport.

        - `longitude` (float) — The longitude of the airport.

        - `elevation_ft` (int) — Elevation of the airport in feet.

        - `iso_country` (str) — ISO 3166-1 alpha-2 code of the country where the airport is located.

        - `iso_region` (str) — ISO 3166-2 code for the state or region.

        - `municipality` (str) — The city or town that the airport serves.


        **Example:** `GET /v1/data/global-airport-locations?limit=10&airport_type=example`'
      operationId: list_endpoint_v1_data_global_airport_locations_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: airport_type
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Type of airport (e.g., 'large_airport', 'heliport').
          examples:
          - example
          title: Airport Type
        description: Type of airport (e.g., 'large_airport', 'heliport').
      - name: iso_country
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: ISO 3166-1 alpha-2 code of the country where the airport is located.
          examples:
          - example
          title: Iso Country
        description: ISO 3166-1 alpha-2 code of the country where the airport is located.
      - name: iso_region
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: ISO 3166-2 code for the state or region.
          examples:
          - example
          title: Iso Region
        description: ISO 3166-2 code for the state or region.
      - name: X-API-Key
        in: header
        required: true
        schema:
          type: string
          title: X-Api-Key
      responses:
        '200':
          description: A page of Global Airport Locations records with pagination metadata.
          content:
            application/json:
              schema: {}
              example:
                data:
                  items:
                  - iata_code: example
                    name: example
                    airport_type: example
                    latitude: 4.2
                    longitude: 4.2
                    elevation_ft: 42
                    iso_country: example
                    iso_region: example
                    municipality: example
                  total: 1
                  limit: 25
                  offset: 0
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/data/global-airport-locations/search:
    get:
      tags:
      - Transportation
      summary: Search Global Airport Locations by name
      description: 'Search Global Airport Locations records by `name` (partial, case-insensitive).


        **Example:** `GET /v1/data/global-airport-locations/search?q=exa`'
      operationId: search_endpoint_v1_data_global_airport_locations_search_get
      parameters:
      - name: q
        in: query
        required: true
        schema:
          type: string
          minLength: 2
          maxLength: 100
          description: Case-insensitive partial match on name.
          examples:
          - exa
          title: Q
        description: Case-insensitive partial match on 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 Global Airport Locations records.
          content:
            application/json:
              schema: {}
              example:
                data:
                  items:
                  - iata_code: example
                    name: example
                    airport_type: example
                    latitude: 4.2
                    longitude: 4.2
                    elevation_ft: 42
                    iso_country: example
                    iso_region: example
                    municipality: example
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/data/global-airport-locations/{key}:
    get:
      tags:
      - Transportation
      summary: Get one Global Airport Locations record by iata_code
      description: 'Fetch a single Global Airport Locations record by its `iata_code`.


        **Example:** `GET /v1/data/global-airport-locations/example`'
      operationId: get_endpoint_v1_data_global_airport_locations__key__get
      parameters:
      - name: key
        in: path
        required: true
        schema:
          type: string
          description: The iata_code value to look up (case-insensitive).
          examples:
          - example
          title: Key
        description: The iata_code 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 Global Airport Locations record.
          content:
            application/json:
              schema: {}
              example:
                data:
                  iata_code: example
                  name: example
                  airport_type: example
                  latitude: 4.2
                  longitude: 4.2
                  elevation_ft: 42
                  iso_country: example
                  iso_region: example
                  municipality: example
        '404':
          content:
            application/json:
              example:
                error:
                  code: NOT_FOUND
                  message: No Global Airport Locations 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