{"openapi":"3.1.0","info":{"title":"Sprinkle aircraft market (read-only)","version":"1.0.0","description":"Aircraft for sale and their asking prices. Prices are asking prices from listings, not sales; fair value is a market read on asking prices, not an appraisal. Sites are named, never linked; no seller contact details."},"servers":[{"url":"https://sprinkle.com/api/v1"}],"paths":{"/listings":{"get":{"operationId":"searchAircraft","summary":"Search aircraft for sale","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","description":"Text to match, e.g. \"Cirrus SR22\" or \"N211RV\""},"description":"Text to match, e.g. \"Cirrus SR22\" or \"N211RV\""},{"name":"type","in":"query","required":false,"schema":{"type":"string","enum":["piston","turboprop","jet","helicopter","glider"]}},{"name":"max_price","in":"query","required":false,"schema":{"type":"integer","description":"Highest asking price, US dollars"},"description":"Highest asking price, US dollars"},{"name":"min_year","in":"query","required":false,"schema":{"type":"integer","description":"Built in or after this year"},"description":"Built in or after this year"},{"name":"max_hours","in":"query","required":false,"schema":{"type":"integer","description":"Most airframe hours"},"description":"Most airframe hours"},{"name":"country","in":"query","required":false,"schema":{"type":"string","description":"ISO 3166-1 alpha-2 country code, e.g. US"},"description":"ISO 3166-1 alpha-2 country code, e.g. US"},{"name":"sort","in":"query","required":false,"schema":{"type":"string","enum":["newest","price","year","hours"]}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50}}],"responses":{"200":{"description":"A page of listings"},"429":{"description":"Over the per-caller budget (60 requests a minute). See Retry-After."},"503":{"description":"The listing source is unavailable. Try again shortly."}}}},"/aircraft/{registration}":{"get":{"operationId":"getAircraft","summary":"One aircraft by registration","parameters":[{"name":"registration","in":"path","required":true,"schema":{"type":"string"},"description":"e.g. N211RV"}],"responses":{"200":{"description":"What each site asks, asking price over time, key facts"},"404":{"description":"Sprinkle holds nothing on it"},"429":{"description":"Over the per-caller budget (60 requests a minute). See Retry-After."},"503":{"description":"The listing source is unavailable. Try again shortly."}}}},"/models/{model_uuid}/market":{"get":{"operationId":"modelMarket","summary":"A model’s asking prices by year built and its fair-value fit","parameters":[{"name":"model_uuid","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"year","in":"query","required":false,"schema":{"type":"integer","description":"Build year to center the fit on (default: the busiest year)"},"description":"Build year to center the fit on (default: the busiest year)"}],"responses":{"200":{"description":"The model’s market"},"404":{"description":"Not a catalog model"},"429":{"description":"Over the per-caller budget (60 requests a minute). See Retry-After."},"503":{"description":"The listing source is unavailable. Try again shortly."}}}},"/fair-value":{"get":{"operationId":"fairValue","summary":"One aircraft’s asking price against similar aircraft","parameters":[{"name":"reg","in":"query","required":true,"schema":{"type":"string"},"description":"Registration, e.g. N211RV"}],"responses":{"200":{"description":"A verdict, or `state` saying why there is none"},"400":{"description":"No registration given"},"429":{"description":"Over the per-caller budget (60 requests a minute). See Retry-After."},"503":{"description":"The listing source is unavailable. Try again shortly."}}}}}}