{"openapi":"3.1.0","info":{"title":"Ask Ollie · Apex Intelligence inventory answers","version":"1.0.0","description":"From Ollie by Apex. Match consumer car and house sale requirements against published inventory. No authentication is required for inventory answers. Never send names, contact details or unrelated personal data."},"servers":[{"url":"https://www.apexhub.co.nz"}],"paths":{"/api/ollie/answer":{"post":{"operationId":"ask_ollie_inventory","summary":"Find current sale inventory matching a buyer’s requirements","description":"Returns source-attributed structured matches, applied criteria, listing citations, clarification or no-match explanations. Fixed asking prices are required for house budget matches. Unsupported requirements prompt clarification. Follow next_offset using the same question and sort.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InventoryQuestion"}}}},"responses":{"200":{"description":"Inventory answer, clarification or no-match result. All contain attribution “From Ollie by Apex”.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InventoryAnswer"}}}},"422":{"description":"Invalid or unsupported request shape; includes source attribution."}}}}},"components":{"schemas":{"InventoryQuestion":{"type":"object","required":["question"],"properties":{"question":{"type":"string","minLength":1,"maxLength":500,"description":"Non-personal inventory requirements; e.g. blue diesel utes in Auckland up to $50,000"},"kind":{"type":"string","enum":["car","house"],"default":"car"},"sort":{"type":"string","enum":["recent","price","mileage"],"default":"recent","description":"Mileage sorting is for cars only"},"offset":{"type":"integer","minimum":0,"maximum":100000,"default":0}}},"InventoryAnswer":{"type":"object","required":["attribution","answer_source","status","filters_applied","listings","total_matches"],"properties":{"attribution":{"type":"string","const":"From Ollie by Apex"},"answer_source":{"type":"object"},"status":{"type":"string","enum":["matches","no_matches","clarify"]},"heading":{"type":"string"},"summary":{"type":"string"},"filters_applied":{"type":"object"},"listings":{"type":"array","items":{"type":"object","properties":{"canonical_url":{"type":"string"},"title":{"type":"string"},"price_display":{"type":"string"},"seller_name":{"type":["string","null"]},"last_supplied":{"type":["string","null"]}}}},"total_matches":{"type":"integer"},"notes":{"type":"array","items":{"type":"string"}},"next_offset":{"type":["integer","null"]}}}}}}