{"openapi":"3.0.3","info":{"title":"commercialisation.ai partner listings","version":"2026-10-13","description":"Sale catalog reference prices in HKD for browsing. Records can change. This response is not a valuation, not investment advice, and not an offer or a contract."},"servers":[{"url":"https://commercialisation.ai"}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}},"security":[{"bearerAuth":[]}],"paths":{"/api/v1/listings":{"get":{"operationId":"listListings","summary":"List public sale listings","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":50}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"default":0}}],"responses":{"200":{"description":"A page of public listing fields"},"401":{"description":"Missing or unknown API key"},"429":{"description":"Rate limit"}}}},"/api/v1/listings/{id}":{"get":{"operationId":"getListing","summary":"Read one public sale listing","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^M\\d+$"}}],"responses":{"200":{"description":"One public listing"},"404":{"description":"Unknown id"}}}}},"x-public-fields":["propertyId","estate","sectionId","districtZh","districtEn","priceHkd","pricePerSqftHkd","unitZh","saleableSqft","layoutZh","layoutEn","floorZh","floorEn","highlightsZh","nearbyZh","photos","listingType","updatedAt"],"x-listing-property-types":{"propertyId":{"type":"string"},"estate":{"type":"string"},"sectionId":{"type":"string"},"districtZh":{"type":"string"},"districtEn":{"type":"string"},"priceHkd":{"type":"string"},"pricePerSqftHkd":{"type":"string"},"unitZh":{"type":"string"},"saleableSqft":{"type":"string"},"layoutZh":{"type":"string"},"layoutEn":{"type":"string"},"floorZh":{"type":"string"},"floorEn":{"type":"string"},"highlightsZh":{"type":"string"},"nearbyZh":{"type":"string"},"photos":{"type":"string"},"listingType":{"type":"string"},"updatedAt":{"type":"string"}}}