{"openapi":"3.1.0","info":{"title":"DM Global — Property Data Layer","version":"1.0.0","description":"Canonical REST API over luxury real-estate inventory for websites and AI agents. Entities: developer → project → property → unit → amenities → community → landmarks."},"servers":[{"url":"https://dmglobal.me/api/v1"}],"paths":{"/properties":{"get":{"operationId":"listProperties","summary":"List properties","parameters":[{"name":"type","in":"query","required":false,"description":"villa|apartment|penthouse|townhouse|unit|land","schema":{"type":"string"}},{"name":"community","in":"query","required":false,"description":"Community name (partial match)","schema":{"type":"string"}},{"name":"developer","in":"query","required":false,"description":"Developer name (partial match)","schema":{"type":"string"}},{"name":"minBedrooms","in":"query","required":false,"description":"Minimum bedrooms","schema":{"type":"integer"}},{"name":"minPrice","in":"query","required":false,"description":"Minimum price in AED","schema":{"type":"number"}},{"name":"maxPrice","in":"query","required":false,"description":"Maximum price in AED","schema":{"type":"number"}},{"name":"offPlan","in":"query","required":false,"description":"true = off-plan, false = ready","schema":{"type":"boolean"}},{"name":"limit","in":"query","required":false,"description":"Page size (1–100, default 24)","schema":{"type":"integer"}},{"name":"offset","in":"query","required":false,"description":"Result offset","schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string"},"total":{"type":"integer"},"data":{"type":"array","items":{"$ref":"#/components/schemas/PropertySummary"}}}}}}}}}},"/properties/{slug}":{"get":{"operationId":"getProperty","summary":"Get a property with its full entity graph","parameters":[{"name":"slug","in":"path","required":true,"description":"Property slug","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Property"}}}},"404":{"description":"Not found"}}}},"/projects":{"get":{"operationId":"listProjects","summary":"List off-plan projects","parameters":[{"name":"limit","in":"query","required":false,"description":"Page size","schema":{"type":"integer"}},{"name":"offset","in":"query","required":false,"description":"Result offset","schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string"},"total":{"type":"integer"},"data":{"type":"array","items":{"$ref":"#/components/schemas/PropertySummary"}}}}}}}}}},"/communities":{"get":{"operationId":"listCommunities","summary":"List communities with nearby landmarks","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string"},"total":{"type":"integer"},"data":{"type":"array","items":{"$ref":"#/components/schemas/Community"}}}}}}}}}},"/developers":{"get":{"operationId":"listDevelopers","summary":"List developers","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string"},"total":{"type":"integer"},"data":{"type":"array","items":{"$ref":"#/components/schemas/Developer"}}}}}}}}}}},"components":{"schemas":{"PropertySummary":{"type":"object","properties":{"id":{"type":"string"},"slug":{"type":"string"},"url":{"type":"string","format":"uri"},"title":{"type":"string"},"propertyType":{"type":"string"},"dealType":{"type":"string","enum":["sale","rent"]},"price":{"$ref":"#/components/schemas/Money"},"bedrooms":{"type":"integer","nullable":true},"bathrooms":{"type":"integer","nullable":true},"areaSqft":{"type":"number","nullable":true},"offPlan":{"type":"boolean"},"community":{"type":"string","nullable":true},"developer":{"type":"string","nullable":true},"image":{"type":"string","nullable":true}}},"Property":{"type":"object","description":"Full canonical property: status, price, size, features, developer, location (community + nearby schools/metros), amenities, units, media, payment plan, timeline and price history.","properties":{"id":{"type":"string"},"slug":{"type":"string"},"title":{"type":"string"},"propertyType":{"type":"string"},"dealType":{"type":"string","enum":["sale","rent"]},"status":{"type":"object"},"price":{"$ref":"#/components/schemas/Money"},"size":{"type":"object"},"features":{"type":"object"},"developer":{"type":"object","nullable":true},"location":{"type":"object"},"amenities":{"type":"array","items":{"type":"string"}},"units":{"type":"array","items":{"type":"object"}},"media":{"type":"object"},"priceHistory":{"type":"object"}}},"Community":{"type":"object","properties":{"name":{"type":"string"},"slug":{"type":"string"},"city":{"type":"string","nullable":true},"emirate":{"type":"string","nullable":true},"propertyCount":{"type":"integer"},"nearbyLandmarks":{"type":"object"}}},"Developer":{"type":"object","properties":{"name":{"type":"string"},"slug":{"type":"string"},"website":{"type":"string","nullable":true},"propertyCount":{"type":"integer"}}},"Money":{"type":"object","properties":{"currency":{"type":"string","example":"AED"},"amount":{"type":"number","nullable":true}}}}}}