{"openapi":"3.0.0","info":{"title":"Avyo Aircraft Rental API","description":"Search and discover aircraft rentals across the United States. Compare hourly rates from flight schools and private owners, view full cost breakdowns, and find availability at any airport.","version":"1.0.0","contact":{"name":"Avyo","email":"hello@avyo.io","url":"https://avyo.io/developers"}},"servers":[{"url":"https://avyo.io","description":"Production"}],"paths":{"/api/search/trips":{"post":{"operationId":"searchTrips","summary":"Search available aircraft","description":"Search for aircraft available to rent by airport code, city name, or GPS coordinates. Returns aircraft with full cost breakdowns including rental, fuel, repositioning, and platform fees.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"departureAirport":{"type":"string","description":"ICAO airport code (e.g. KAUS)","example":"KAUS"},"originCity":{"type":"string","description":"City name (alternative to airport code)","example":"Austin"},"originRadius":{"type":"string","description":"Search radius in miles (default: 30)","example":"30"},"originLat":{"type":"number","description":"Latitude for GPS-based search"},"originLon":{"type":"number","description":"Longitude for GPS-based search"},"departureDate":{"type":"string","format":"date-time","description":"ISO 8601 departure date/time"},"returnDate":{"type":"string","format":"date-time","description":"ISO 8601 return date/time"},"passengers":{"type":"integer","minimum":1,"maximum":20,"description":"Number of passengers"},"filters":{"type":"object","properties":{"maxPrice":{"type":"number","description":"Maximum hourly rate in USD"},"minSeats":{"type":"integer","description":"Minimum seat count"}}}}}}}},"responses":{"200":{"description":"Search results with aircraft and cost breakdowns","content":{"application/json":{"schema":{"type":"object","properties":{"aircraft":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"make":{"type":"string","example":"Cessna"},"model":{"type":"string","example":"172"},"year":{"type":"integer","example":2019},"hourlyRate":{"type":"number","example":185},"fuelPolicy":{"type":"string","enum":["WET","DRY"]},"seats":{"type":"integer","example":4},"speed":{"type":"number","example":122},"homeBaseAirport":{"type":"string","example":"KAUS"},"images":{"type":"array","items":{"type":"string"}},"costBreakdown":{"type":"object","properties":{"hourlyRate":{"type":"number"},"rentalHours":{"type":"number"},"subtotal":{"type":"number"},"fuelCost":{"type":"number"},"repositioningFee":{"type":"number"},"platformFee":{"type":"number"},"total":{"type":"number"}}},"distanceToOrigin":{"type":"number"}}}},"searchParams":{"type":"object","properties":{"originAirports":{"type":"array","items":{"type":"object","properties":{"icao":{"type":"string"},"name":{"type":"string"},"city":{"type":"string"},"state":{"type":"string"},"distance":{"type":"number"}}}},"searchType":{"type":"string","enum":["airport","city","geolocation"]}}}}}}}}}}},"/api/aircraft/featured":{"get":{"operationId":"getFeaturedAircraft","summary":"Browse featured aircraft","description":"Get featured aircraft listings grouped by featured status, location, or recency.","parameters":[{"name":"groupBy","in":"query","schema":{"type":"string","enum":["featured","location","recent"],"default":"featured"},"description":"How to group results"},{"name":"limit","in":"query","schema":{"type":"integer","default":12},"description":"Maximum number of results"},{"name":"location","in":"query","schema":{"type":"string"},"description":"Filter by ICAO airport code"}],"responses":{"200":{"description":"List of featured aircraft","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"make":{"type":"string"},"model":{"type":"string"},"year":{"type":"integer"},"hourlyRate":{"type":"number"},"images":{"type":"array","items":{"type":"string"}},"homeBaseAirport":{"type":"string"},"seats":{"type":"integer"},"speed":{"type":"number"},"rating":{"type":"number"},"reviewCount":{"type":"integer"}}}},"count":{"type":"integer"},"groupedBy":{"type":"string"}}}}}}}}},"/api/airports/search":{"get":{"operationId":"searchAirports","summary":"Search airports","description":"Search US airports by name, city, ICAO code, IATA code, or geolocation.","parameters":[{"name":"q","in":"query","schema":{"type":"string","minLength":2},"description":"Search query — matches city, ICAO, IATA, name, or state"},{"name":"lat","in":"query","schema":{"type":"number"},"description":"Latitude for proximity search"},{"name":"lon","in":"query","schema":{"type":"number"},"description":"Longitude for proximity search"},{"name":"maxDistance","in":"query","schema":{"type":"number","default":50},"description":"Max distance in miles (geolocation mode)"}],"responses":{"200":{"description":"List of matching airports","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","example":"KAUS"},"icao":{"type":"string","example":"KAUS"},"iata":{"type":"string","example":"AUS"},"name":{"type":"string","example":"Austin-Bergstrom International Airport"},"city":{"type":"string","example":"Austin"},"state":{"type":"string","example":"TX"},"type":{"type":"string","example":"large_airport"},"distance":{"type":"number","description":"Distance in miles (geolocation only)"}}}}}}}}}}}}