{"openapi":"3.1.0","info":{"title":"The Runs List Public Query API","version":"1.0.0","description":"The supported public integration for submitting buyer vehicle demand to a participating The Runs List broker.","contact":{"name":"The Runs List Support","email":"support@therunslist.com","url":"https://www.therunslist.com/contact"}},"externalDocs":{"description":"The Runs List developer resources","url":"https://www.therunslist.com/developers"},"servers":[{"url":"https://www.therunslist.com","description":"Production"}],"paths":{"/api/public-query":{"post":{"operationId":"submitBuyerVehicleDemand","summary":"Submit buyer vehicle demand to a broker","description":"Creates or updates a buyer lead for the broker identified by the supplied public team code. Obtain the user's authorization before submitting personal information.","tags":["Public query"],"security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicQuerySubmission"}}}},"responses":{"201":{"description":"Buyer demand accepted","content":{"application/json":{"schema":{"type":"object","required":["success","merged"],"properties":{"success":{"type":"boolean","const":true},"merged":{"type":"boolean","description":"Whether the submission was merged into an existing buyer."}}}}}},"400":{"description":"Invalid JSON or validation failure","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"403":{"description":"The broker is not accepting new requests","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"404":{"description":"Unknown public team code","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"500":{"description":"Submission failed","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}}}}}},"components":{"schemas":{"PublicQuerySubmission":{"type":"object","additionalProperties":false,"required":["shortId","name","email","vehicles"],"properties":{"shortId":{"type":"string","pattern":"^[ABCDEFGHJKMNPQRSTUVWXYZ23456789]{6}$","description":"Six-character public code supplied by the broker."},"name":{"type":"string","minLength":1,"maxLength":120},"email":{"type":"string","format":"email","maxLength":254},"vehicles":{"type":"array","minItems":1,"maxItems":10,"items":{"$ref":"#/components/schemas/VehicleDemand"}}}},"VehicleDemand":{"type":"object","additionalProperties":false,"required":["make"],"properties":{"make":{"type":"string","minLength":1,"maxLength":80},"model":{"type":"string","maxLength":120},"minYear":{"type":"integer","minimum":1900,"maximum":2100},"maxYear":{"type":"integer","minimum":1900,"maximum":2100},"maxMileage":{"type":"integer","minimum":0,"maximum":1000000},"condition":{"type":"string","enum":["clean","salvage","rebuilt"]},"maxBudget":{"type":"number","minimum":0,"maximum":10000000}}}}}}