{"openapi":"3.1.0","info":{"title":"VoloMarket Public API","version":"1.0.0","summary":"Global marketplace for buying, selling and renting aircraft, gliders, helicopters, engines, avionics and aviation parts.","description":"Read-only access to active VoloMarket listings, manufacturers, models and asking-price statistics. No authentication. Rate limited to 120 requests per minute per IP. All data is public and equivalent to what a visitor sees on the website. Specifications are seller-stated and unverified; prices are asking prices. An MCP server exposing the same data as callable tools is available at /api/mcp.","contact":{"url":"https://volomarket.net/contact"},"termsOfService":"https://volomarket.net/terms"},"servers":[{"url":"https://volomarket.net/api/public/v1"}],"paths":{"/listings":{"get":{"operationId":"searchListings","summary":"Search active listings","description":"Full-text and structured search across active listings. Combine `q` with filters. Specification tables are omitted here for size — fetch a single listing for those.","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string"},"description":"Free text matched against title, make, model, description and location."},{"name":"type","in":"query","required":false,"schema":{"type":"string","enum":["aircraft","gliders","rotorcraft","light","drones","parts","gear","rent"]},"description":"Browse bucket; `rent` selects rental listings."},{"name":"category","in":"query","required":false,"schema":{"type":"string","enum":["AIRCRAFT","ULTRALIGHT","EXPERIMENTAL","WARBIRD","GLIDER","MOTOR_GLIDER","TOURING_MOTOR_GLIDER","HELICOPTER","GYROPLANE","BALLOON","PARAMOTOR","DRONE","ENGINE","AVIONICS","PROPELLER","PART","GROUND_EQUIPMENT","PILOT_GEAR","SIMULATOR"]},"description":"Exact category. Takes precedence over `type`."},{"name":"make","in":"query","required":false,"schema":{"type":"string"},"description":"Manufacturer name; matched on a normalised slug."},{"name":"model","in":"query","required":false,"schema":{"type":"string"},"description":"Model name; use together with `make`."},{"name":"country","in":"query","required":false,"schema":{"type":"string"},"description":"Country where the aircraft is located."},{"name":"minPriceEur","in":"query","required":false,"schema":{"type":"number"},"description":"Minimum asking price. Compared against the seller's own currency, so the bound is approximate for non-EUR listings; every result reports its currency and an EUR equivalent."},{"name":"maxPriceEur","in":"query","required":false,"schema":{"type":"number"},"description":"Maximum asking price. Compared against the seller's own currency, so the bound is approximate for non-EUR listings; every result reports its currency and an EUR equivalent."},{"name":"yearFrom","in":"query","required":false,"schema":{"type":"integer"},"description":"Earliest year of manufacture."},{"name":"yearTo","in":"query","required":false,"schema":{"type":"integer"},"description":"Latest year of manufacture."},{"name":"maxTotalTimeHours","in":"query","required":false,"schema":{"type":"number"},"description":"Maximum airframe total time in hours."},{"name":"minSeats","in":"query","required":false,"schema":{"type":"integer"},"description":"Minimum number of seats."},{"name":"ifrCertified","in":"query","required":false,"schema":{"type":"boolean"},"description":"Only aircraft the seller states are IFR certified."},{"name":"rentable","in":"query","required":false,"schema":{"type":"boolean"},"description":"true = rentals only; false = for sale only."},{"name":"sort","in":"query","required":false,"schema":{"type":"string","enum":["relevance","newest","oldest","price_asc","price_desc","year_desc","year_asc","hours_asc"]},"description":"Result ordering. Default `newest`."},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1},"description":"1-based page number."},{"name":"pageSize","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50},"description":"Results per page, max 50. Default 20."}],"responses":{"200":{"description":"Matching listings.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"url":{"type":"string","format":"uri","description":"Canonical listing page — always cite this when quoting a listing."},"title":{"type":"string"},"description":{"type":["string","null"]},"category":{"type":"string","enum":["AIRCRAFT","ULTRALIGHT","EXPERIMENTAL","WARBIRD","GLIDER","MOTOR_GLIDER","TOURING_MOTOR_GLIDER","HELICOPTER","GYROPLANE","BALLOON","PARAMOTOR","DRONE","ENGINE","AVIONICS","PROPELLER","PART","GROUND_EQUIPMENT","PILOT_GEAR","SIMULATOR"]},"categoryLabel":{"type":"string"},"make":{"type":["string","null"]},"model":{"type":["string","null"]},"year":{"type":["integer","null"]},"registration":{"type":["string","null"]},"totalTimeHours":{"type":["number","null"],"description":"Airframe total time, seller-stated."},"engineSmohHours":{"type":["number","null"],"description":"Engine hours since major overhaul, seller-stated."},"price":{"type":"object","properties":{"amount":{"type":["number","null"],"description":"Asking price in the seller's currency."},"currency":{"type":"string"},"amountEur":{"type":["number","null"],"description":"Indicative EUR equivalent at daily ECB reference rates."},"vatStatus":{"type":"string"},"vatStatusLabel":{"type":["string","null"]},"vatRatePercent":{"type":["number","null"]}}},"rental":{"type":["object","null"],"description":"Present when the listing is offered for rent."},"shipping":{"type":["object","null"]},"location":{"type":"object","properties":{"city":{"type":["string","null"]},"country":{"type":["string","null"]},"airportIcao":{"type":["string","null"]},"latitude":{"type":["number","null"]},"longitude":{"type":["number","null"]}}},"seller":{"type":["object","null"],"description":"Included on the single-listing endpoint only."},"images":{"type":"array","items":{"type":"string","format":"uri"}},"videoUrl":{"type":["string","null"]},"specifications":{"type":"array","description":"Category-specific specification groups. Empty in search results; populated on the single-listing endpoint.","items":{"type":"object","properties":{"section":{"type":"string"},"fields":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"label":{"type":"string"},"value":{"type":"string"}}}}}}},"status":{"type":"string"},"publishedAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"disclaimer":{"type":"string"}}}},"meta":{"type":"object","properties":{"total":{"type":"integer"},"page":{"type":"integer"},"pageSize":{"type":"integer"},"totalPages":{"type":"integer"}}},"attribution":{"type":"string"}}}}}},"429":{"description":"Rate limit exceeded."}}}},"/listings/{id}":{"get":{"operationId":"getListing","summary":"Read one listing","description":"Full listing including every filled specification field and seller detail.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Listing UUID or the `{slug}-{uuid}` segment from the listing URL."}],"responses":{"200":{"description":"The listing.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"url":{"type":"string","format":"uri","description":"Canonical listing page — always cite this when quoting a listing."},"title":{"type":"string"},"description":{"type":["string","null"]},"category":{"type":"string","enum":["AIRCRAFT","ULTRALIGHT","EXPERIMENTAL","WARBIRD","GLIDER","MOTOR_GLIDER","TOURING_MOTOR_GLIDER","HELICOPTER","GYROPLANE","BALLOON","PARAMOTOR","DRONE","ENGINE","AVIONICS","PROPELLER","PART","GROUND_EQUIPMENT","PILOT_GEAR","SIMULATOR"]},"categoryLabel":{"type":"string"},"make":{"type":["string","null"]},"model":{"type":["string","null"]},"year":{"type":["integer","null"]},"registration":{"type":["string","null"]},"totalTimeHours":{"type":["number","null"],"description":"Airframe total time, seller-stated."},"engineSmohHours":{"type":["number","null"],"description":"Engine hours since major overhaul, seller-stated."},"price":{"type":"object","properties":{"amount":{"type":["number","null"],"description":"Asking price in the seller's currency."},"currency":{"type":"string"},"amountEur":{"type":["number","null"],"description":"Indicative EUR equivalent at daily ECB reference rates."},"vatStatus":{"type":"string"},"vatStatusLabel":{"type":["string","null"]},"vatRatePercent":{"type":["number","null"]}}},"rental":{"type":["object","null"],"description":"Present when the listing is offered for rent."},"shipping":{"type":["object","null"]},"location":{"type":"object","properties":{"city":{"type":["string","null"]},"country":{"type":["string","null"]},"airportIcao":{"type":["string","null"]},"latitude":{"type":["number","null"]},"longitude":{"type":["number","null"]}}},"seller":{"type":["object","null"],"description":"Included on the single-listing endpoint only."},"images":{"type":"array","items":{"type":"string","format":"uri"}},"videoUrl":{"type":["string","null"]},"specifications":{"type":"array","description":"Category-specific specification groups. Empty in search results; populated on the single-listing endpoint.","items":{"type":"object","properties":{"section":{"type":"string"},"fields":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"label":{"type":"string"},"value":{"type":"string"}}}}}}},"status":{"type":"string"},"publishedAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"disclaimer":{"type":"string"}}}}}}}},"404":{"description":"No active listing with that identifier."}}}},"/makes":{"get":{"operationId":"listMakes","summary":"Manufacturers with active inventory","parameters":[{"name":"type","in":"query","required":false,"schema":{"type":"string","enum":["aircraft","gliders","rotorcraft","light","drones","parts","gear","rent"]},"description":"Restrict to a browse bucket."},{"name":"category","in":"query","required":false,"schema":{"type":"string","enum":["AIRCRAFT","ULTRALIGHT","EXPERIMENTAL","WARBIRD","GLIDER","MOTOR_GLIDER","TOURING_MOTOR_GLIDER","HELICOPTER","GYROPLANE","BALLOON","PARAMOTOR","DRONE","ENGINE","AVIONICS","PROPELLER","PART","GROUND_EQUIPMENT","PILOT_GEAR","SIMULATOR"]},"description":"Restrict to one category."}],"responses":{"200":{"description":"Manufacturers and listing counts."}}}},"/models":{"get":{"operationId":"listModels","summary":"Models with active inventory for a manufacturer","parameters":[{"name":"make","in":"query","required":true,"schema":{"type":"string"},"description":"Manufacturer name."},{"name":"type","in":"query","required":false,"schema":{"type":"string","enum":["aircraft","gliders","rotorcraft","light","drones","parts","gear","rent"]},"description":"Restrict to a browse bucket."},{"name":"category","in":"query","required":false,"schema":{"type":"string","enum":["AIRCRAFT","ULTRALIGHT","EXPERIMENTAL","WARBIRD","GLIDER","MOTOR_GLIDER","TOURING_MOTOR_GLIDER","HELICOPTER","GYROPLANE","BALLOON","PARAMOTOR","DRONE","ENGINE","AVIONICS","PROPELLER","PART","GROUND_EQUIPMENT","PILOT_GEAR","SIMULATOR"]},"description":"Restrict to one category."}],"responses":{"200":{"description":"Models and listing counts."},"400":{"description":"`make` missing."}}}},"/market-stats":{"get":{"operationId":"getMarketStats","summary":"Asking-price statistics for a make or model","description":"Minimum, median and maximum asking price in EUR across currently active listings, plus model-year span and median airframe hours. Returns null statistics below three listings. Advertised prices, not sale prices.","parameters":[{"name":"make","in":"query","required":true,"schema":{"type":"string"},"description":"Manufacturer name."},{"name":"model","in":"query","required":false,"schema":{"type":"string"},"description":"Optional model for a narrower sample."},{"name":"category","in":"query","required":false,"schema":{"type":"string","enum":["AIRCRAFT","ULTRALIGHT","EXPERIMENTAL","WARBIRD","GLIDER","MOTOR_GLIDER","TOURING_MOTOR_GLIDER","HELICOPTER","GYROPLANE","BALLOON","PARAMOTOR","DRONE","ENGINE","AVIONICS","PROPELLER","PART","GROUND_EQUIPMENT","PILOT_GEAR","SIMULATOR"]},"description":"Optional category restriction."}],"responses":{"200":{"description":"Statistics."},"400":{"description":"`make` missing."}}}},"/categories":{"get":{"operationId":"listCategories","summary":"Category vocabulary","description":"Every category, browse bucket and landing page — the vocabulary the other endpoints accept.","responses":{"200":{"description":"Categories, types and landing pages."}}}}}}