{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://auctionsignal.app/auctionfeed/v1.json","title":"AuctionFeed v1","description":"A small, open schema for publishing auction events and lots. Free to implement, no attribution required. If auction software vendors adopt it, everyone's coverage improves.","type":"object","required":["version","event","lots"],"properties":{"version":{"const":"1.0"},"event":{"type":"object","required":["id","title","url"],"properties":{"id":{"type":"string"},"title":{"type":"string"},"url":{"type":"string","format":"uri"},"seller_name":{"type":"string"},"seller_type":{"enum":["municipality","utility","dealer","fleet","bank","private","unknown"]},"starts_at":{"type":"string","format":"date-time"},"ends_at":{"type":"string","format":"date-time"},"inspection_from":{"type":"string","format":"date-time"},"inspection_to":{"type":"string","format":"date-time"},"removal_by":{"type":"string","format":"date-time"},"buyer_premium_bps":{"type":"integer","minimum":0,"maximum":5000},"terms_url":{"type":"string","format":"uri"},"location":{"$ref":"#/$defs/location"}}},"lots":{"type":"array","items":{"type":"object","required":["id","title","url","closes_at"],"properties":{"id":{"type":"string"},"lot_number":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"url":{"type":"string","format":"uri"},"category":{"type":"string","description":"Dotted taxonomy path, e.g. truck.dump"},"manufacturer":{"type":"string"},"model":{"type":"string"},"model_year":{"type":"integer"},"identifiers":{"type":"object","properties":{"vin":{"type":"string"},"serial":{"type":"string"}}},"specs":{"type":"object","additionalProperties":true},"condition":{"enum":["new","operational","repairable","parts_only","unknown"]},"quantity":{"type":"integer","minimum":1},"current_bid":{"$ref":"#/$defs/money"},"reserve_state":{"enum":["met","not_met","none","unknown"]},"closes_at":{"type":"string","format":"date-time"},"extension_rule":{"type":"string","description":"e.g. 'soft close: +2 min on bids in final 2 min'"},"status":{"enum":["open","closed","cancelled","withdrawn"]},"images":{"type":"array","items":{"type":"string","format":"uri"}},"location":{"$ref":"#/$defs/location"}}}}},"$defs":{"money":{"type":"object","required":["amount","currency"],"properties":{"amount":{"type":"number"},"currency":{"type":"string","minLength":3,"maxLength":3}}},"location":{"type":"object","properties":{"address":{"type":"string"},"city":{"type":"string"},"region":{"type":"string"},"postal_code":{"type":"string"},"country":{"type":"string","minLength":2,"maxLength":2},"lat":{"type":"number"},"lon":{"type":"number"}}}}}