{"openapi":"3.1.0","info":{"title":"GovAuctions Data API","version":"1.0.0","description":"Structured government-surplus auction data. Live listings (facts only, no images) cover sanctioned federal sources (GSA Auctions). Sold-price comps and our proprietary Flip Score resale signal are derived aggregates computed across the full US surplus market. Plans: Free (free); Hobby ($49/mo); Enterprise (contact us). Get a key at https://govauctions.app/developers."},"servers":[{"url":"https://govauctions.app/api/v1"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Your API key as a Bearer token (or send it as the x-api-key header)."}}},"paths":{"/listings":{"get":{"summary":"Search live listings (facts only, GSA Auctions)","parameters":[{"name":"country","in":"query","schema":{"type":"string","enum":["US"],"default":"US"}},{"name":"state","in":"query","schema":{"type":"string"},"description":"2-letter state/region code"},{"name":"category","in":"query","schema":{"type":"string"}},{"name":"source","in":"query","schema":{"type":"string","enum":["gsa"],"default":"gsa"},"description":"Source platform (sanctioned sources only; currently gsa)"},{"name":"q","in":"query","schema":{"type":"string"},"description":"Title keyword"},{"name":"priceMin","in":"query","schema":{"type":"number"}},{"name":"priceMax","in":"query","schema":{"type":"number"}},{"name":"active","in":"query","schema":{"type":"boolean","default":true}},{"name":"limit","in":"query","schema":{"type":"integer","maximum":100,"default":25}},{"name":"offset","in":"query","schema":{"type":"integer","default":0}}],"responses":{"200":{"description":"A page of listings"}}}},"/listings/{id}":{"get":{"summary":"Get one live listing by id","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Listing"},"404":{"description":"Not found"}}}},"/comps":{"get":{"summary":"Sold-price range for a described item (full-market aggregate)","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"},"description":"Item description, e.g. '2015 Ford F-150'"},{"name":"category","in":"query","schema":{"type":"string"}},{"name":"country","in":"query","schema":{"type":"string","enum":["US"],"default":"US"}}],"responses":{"200":{"description":"Comp range (p25/median/p75)"},"403":{"description":"Not in plan"}}}},"/flip-score":{"get":{"summary":"Flip Score resale signal for a GSA listing (full-market valuation model)","parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string"},"description":"GSA listing id"}],"responses":{"200":{"description":"Flip Score, estimated value, discount"},"403":{"description":"Not in plan"}}}}}}