Altivo Jets API

openapi: 3.1.0
info:
  title: Altivo Jets API
  version: '2026-11-01'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-11-01: 4 operation(s) read from 1 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; Altivo Jets has published no machine-readable contract that the
    pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 0
    documentation: 4
    pages-with-code: 1
    pages-read: 1
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-11-01'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://altivojets.com/developers
paths:
  /api/v1/estimate:
    get:
      operationId: get_api_v1_estimate
      tags:
      - Api
      summary: Indicative full‑charter price by aircraft size, one‑way or return, in the local currency of the departure market.
      x-source: https://altivojets.com/developers
      parameters:
      - name: origin
        in: query
        required: true
        schema:
          type: string
        description: Origin city or airport code.
      - name: destination
        in: query
        required: true
        schema:
          type: string
        description: Destination city or airport code.
      - name: passengers
        in: query
        required: true
        schema:
          type: string
        description: Number of passengers.
      - name: one_way
        in: query
        required: false
        schema:
          type: string
        description: Set to true for a one‑way estimate.
      - name: aircraft_size
        in: query
        required: false
        schema:
          type: string
        description: Preferred aircraft size category.
      - name: market
        in: query
        required: false
        schema:
          type: string
        description: Market/country to price in local currency.
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1EstimateResponse'
      x-evidence:
        kind: documentation
  /api/v1/legs:
    get:
      operationId: get_api_v1_legs
      tags:
      - Api
      summary: Search live empty leg flights (whole aircraft, discounted repositioning flights) by origin, destination, date window, passengers,
        market and an optional price ceiling.
      x-source: https://altivojets.com/developers
      parameters:
      - name: origin
        in: query
        required: true
        schema:
          type: string
        description: Origin city or airport code.
      - name: destination
        in: query
        required: false
        schema:
          type: string
        description: Destination city or airport code.
      - name: date_from
        in: query
        required: false
        schema:
          type: string
        description: Start of the departure window.
      - name: date_to
        in: query
        required: false
        schema:
          type: string
        description: End of the departure window.
      - name: passengers
        in: query
        required: true
        schema:
          type: string
        description: Number of passengers.
      - name: market
        in: query
        required: false
        schema:
          type: string
        description: Market/country to price in local currency.
      - name: price_ceiling
        in: query
        required: false
        schema:
          type: string
        description: Optional maximum price to filter results.
      - name: limit
        in: query
        required: false
        schema:
          type: string
        description: Maximum number of legs to return (default 5, max 20).
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1LegsResponse'
      x-evidence:
        kind: documentation
  /api/v1/quotes/:
    post:
      operationId: post_api_v1_quotes
      tags:
      - Api
      summary: Send the traveller's trip and contact details to the Altivo Jets desk for a full charter or a specific empty leg.
      x-source: https://altivojets.com/developers
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV1QuotesRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiV1QuotesResponse'
      x-evidence:
        kind: documentation
  /mcp/:
    get:
      operationId: get_mcp
      tags:
      - Mcp
      summary: Altivo Jets MCP server base URL (used for JSON‑RPC tool calls).
      x-source: https://altivojets.com/developers
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetMcpResponse'
      x-evidence:
        kind: documentation
components:
  schemas:
    GetApiV1EstimateResponse:
      type: object
      properties:
        price_range:
          type: object
          description: Indicative price range before taxes.
        estimated_taxes:
          type: object
          description: Estimated taxes for the trip.
        all_in_range:
          type: object
          description: All‑in price range including taxes.
        flight_time:
          type: string
          description: Estimated flight time.
        fuel_stops:
          type: integer
          description: Estimated number of fuel stops.
        recommended_aircraft:
          type: string
          description: Suggested aircraft size for the request.
    GetApiV1LegsResponse:
      type: object
      properties:
        legs:
          type: array
          description: Array of empty leg objects with route, departure window, aircraft, seats, price, taxes, all‑in estimate, full‑charter comparison
            and booking link.
    PostApiV1QuotesRequest:
      type: object
      properties:
        origin:
          type: string
          description: Origin city or airport code.
        destination:
          type: string
          description: Destination city or airport code.
        passengers:
          type: string
          description: Number of passengers.
        departure_date:
          type: string
          description: Planned departure date.
        return_date:
          type: string
          description: Planned return date (if round‑trip).
        empty_leg_ref:
          type: string
          description: Reference ID of a specific empty leg, if quoting that leg.
        traveller_name:
          type: string
          description: Name of the traveller.
        traveller_email:
          type: string
          description: Email address of the traveller.
        traveller_phone:
          type: string
          description: Phone number of the traveller.
        additional_notes:
          type: string
          description: Any extra information for the charter specialist.
      required:
      - origin
      - destination
      - passengers
      - departure_date
      - traveller_name
      - traveller_email
    PostApiV1QuotesResponse:
      type: object
      properties:
        quote_id:
          type: string
          description: Identifier for the created quote request.
        status:
          type: string
          description: Current status (e.g., pending, sent to specialist).
    GetMcpResponse:
      type: object
      properties:
        message:
          type: string
          description: Plain JSON response indicating the endpoint is reachable.
tags:
- name: Api
- name: Mcp