{"openapi":"3.1.0","info":{"title":"Chope API","version":"0.1.0","description":"Singapore property almanac. Open JSON over HTTPS."},"servers":[{"url":"/api"}],"paths":{"/listings.json":{"get":{"summary":"List resale and new-launch listings","parameters":[{"name":"type","in":"query","schema":{"type":"string","enum":["hdb","condo","landed","new-launch"]}},{"name":"district","in":"query","schema":{"type":"string","pattern":"^D\\d{1,2}$"}},{"name":"verified","in":"query","schema":{"type":"string","enum":["1"]}},{"name":"price_min","in":"query","schema":{"type":"integer"}},{"name":"price_max","in":"query","schema":{"type":"integer"}},{"name":"limit","in":"query","schema":{"type":"integer","default":100,"maximum":500}},{"name":"offset","in":"query","schema":{"type":"integer","default":0}}],"responses":{"200":{"description":"Paginated listings"}}}},"/listing/{id}":{"get":{"summary":"Fetch one listing by id","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Listing record"},"404":{"description":"Not found"}}}},"/wishlists.json":{"get":{"summary":"Open wishlists","responses":{"200":{"description":"List of wishlists"}}},"post":{"summary":"Post a buyer wishlist","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WishlistInput"}}}},"responses":{"201":{"description":"Created"}}}},"/heatmap.json":{"get":{"summary":"Demand register","responses":{"200":{"description":"Per-block demand cells"}}}},"/new-launches.json":{"get":{"summary":"Active new launches","responses":{"200":{"description":"Launches"}}}},"/search.json":{"get":{"summary":"Search listings","parameters":[{"name":"q","in":"query","schema":{"type":"string"}},{"name":"type","in":"query","schema":{"type":"string"}},{"name":"district","in":"query","schema":{"type":"string"}},{"name":"sort","in":"query","schema":{"type":"string","enum":["relevance","newest","price-asc","price-desc","psf-asc","lease-most"]}}],"responses":{"200":{"description":"Hits"}}}},"/calc/hfe-tdsr":{"post":{"summary":"Compute HFE + TDSR + MSR at the 4.0% stress rate","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HfeInput"}}}},"responses":{"200":{"description":"Computed bands"}}}}},"components":{"schemas":{"WishlistInput":{"type":"object","required":["looking_for"],"properties":{"looking_for":{"type":"object","properties":{"types":{"type":"array","items":{"type":"string"}},"districts":{"type":"array","items":{"type":"string"}},"price_max":{"type":"integer"},"bedrooms_min":{"type":"integer"},"must_have":{"type":"array","items":{"type":"string"}},"deal_breaker":{"type":"array","items":{"type":"string"}}}},"pre_approved":{"type":"boolean"},"monthly_loan_capacity_sgd":{"type":"integer"}}},"HfeInput":{"type":"object","required":["price_sgd","monthly_income_sgd"],"properties":{"price_sgd":{"type":"integer"},"monthly_income_sgd":{"type":"integer"},"partner_income_sgd":{"type":"integer"},"other_monthly_debt_sgd":{"type":"integer"},"type":{"type":"string","enum":["hdb","private"]},"tenure_years":{"type":"integer","minimum":5,"maximum":30}}}}}}