{"openapi":"3.1.0","info":{"title":"FairSqft API","version":"0.1.0","description":"Dubai property facts from Dubai Land Department open data: fair price ranges, comparables, rents, trend and forecast with abstention. Free, rate-limited, read-only. Same tools as the MCP server at https://fairsqft.com/mcp. Source: Dubai Land Department (DLD) open data, published on data.dubai. Analysis: FairSqft. Not endorsed by the DLD or the Government of Dubai. These derived DLD figures are offered under the same Open Data Licence, with no additional terms (clauses 3.1 and 3.3). Credit the Dubai Land Department and link the source dataset (clause 3.2). Do not imply endorsement by the DLD or the Government of Dubai (clause 3.2.2). Based on Dubai Land Department open data. Not a valuation, not financial advice.","termsOfService":"https://fairsqft.com/developers/","contact":{"email":"hello@fairsqft.com","url":"https://fairsqft.com/developers/"}},"servers":[{"url":"https://fairsqft.com/api/v1"}],"paths":{"/areas":{"get":{"operationId":"list_areas","summary":"List covered Dubai areas","description":"Dubai areas covered, with data freshness and coverage level.","parameters":[{"name":"query","in":"query","required":false,"description":"Optional: part of the area name, e.g. \"marina\".","schema":{"type":"string"}},{"name":"coverage","in":"query","required":false,"description":"Optional filter.","schema":{"type":"string","enum":["full","partial","abstain"]}},{"name":"property_type","in":"query","required":false,"description":"Optional filter.","schema":{"type":"string","enum":["apartment","villa","townhouse"]}},{"name":"limit","in":"query","required":false,"description":"Optional: at most this many areas (busiest first).","schema":{"type":"integer","minimum":1,"maximum":500}},{"name":"detail","in":"query","required":false,"description":"Optional: add rent, off-plan, segment and building counts per area.","schema":{"type":"boolean"}}],"responses":{"200":{"description":"Result. Includes as_of, sources, method_url, abstain, reason, attribution and disclaimer.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid arguments","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"429":{"description":"Rate limit exceeded"}}}},"/areas/{area}/snapshot":{"get":{"operationId":"get_area_snapshot","summary":"Area price and rent snapshot","description":"Price and rent ranges from registered DLD deals and Ejari contracts, with sample sizes, 12-month forecast interval and our public backtest. Abstains when the sample is too small.","parameters":[{"name":"area","in":"path","required":true,"description":"Area name or slug: any of the Dubai areas from list_areas, e.g. \"Dubai Marina\", \"jumeirah-village-circle\", \"JVC\" or \"Jumeirah Park\".","schema":{"type":"string"}},{"name":"segment","in":"query","required":false,"description":"Segment key from get_area_snapshot, e.g. \"apartment-1br\" or \"villa-4br\". Optional: all segments if omitted.","schema":{"type":"string"}},{"name":"building","in":"query","required":false,"description":"Building name as registered with DLD (apartments), e.g. \"Marina Gate 1\". Optional: that building (with comparables when segment is also given).","schema":{"type":"string"}}],"responses":{"200":{"description":"Result. Includes as_of, sources, method_url, abstain, reason, attribution and disclaimer.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid arguments","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"429":{"description":"Rate limit exceeded"}}}},"/areas/{area}/check-price":{"get":{"operationId":"check_price","summary":"Check an asking price or rent","description":"Compares an asking price or rent against the fair range from real closed deals in the same segment.","parameters":[{"name":"area","in":"path","required":true,"description":"Area name or slug: any of the Dubai areas from list_areas, e.g. \"Dubai Marina\", \"jumeirah-village-circle\", \"JVC\" or \"Jumeirah Park\".","schema":{"type":"string"}},{"name":"property_type","in":"query","required":true,"description":"","schema":{"type":"string","enum":["apartment","villa","townhouse"]}},{"name":"bedrooms","in":"query","required":false,"description":"Bedrooms: 0-10, or \"studio\" (= 0). Give bedrooms or layout.","schema":{"type":["integer","string"]}},{"name":"layout","in":"query","required":false,"description":"Segment key from get_area_snapshot. Give bedrooms or layout.","schema":{"type":"string"}},{"name":"size_sqft","in":"query","required":false,"description":"Size in sqft: unit area for apartments, built-up area (BUA) for villas and townhouses.","schema":{"type":"number"}},{"name":"plot_sqft","in":"query","required":false,"description":"Plot size in sqft (villas and townhouses).","schema":{"type":"number"}},{"name":"bua_sqft","in":"query","required":false,"description":"Built-up area in sqft (villas and townhouses).","schema":{"type":"number"}},{"name":"building","in":"query","required":false,"description":"Building name as registered with DLD (apartments), e.g. \"Marina Gate 1\". Optional: compares with the building when DLD has 6+ ready sales of that type in it in 12 months.","schema":{"type":"string"}},{"name":"price_aed","in":"query","required":true,"description":"Asking price in AED, or annual rent in AED when intent is rent.","schema":{"type":"number"}},{"name":"intent","in":"query","required":false,"description":"","schema":{"type":"string","enum":["buy","rent"],"default":"buy"}}],"responses":{"200":{"description":"Result. Includes as_of, sources, method_url, abstain, reason, attribution and disclaimer.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid arguments","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"429":{"description":"Rate limit exceeded"}}}},"/areas/{area}/comparables":{"get":{"operationId":"get_comparables","summary":"Recent registered sales","description":"Recent registered sales in the segment: date, price, size, type.","parameters":[{"name":"area","in":"path","required":true,"description":"Area name or slug: any of the Dubai areas from list_areas, e.g. \"Dubai Marina\", \"jumeirah-village-circle\", \"JVC\" or \"Jumeirah Park\".","schema":{"type":"string"}},{"name":"segment","in":"query","required":true,"description":"Segment key from get_area_snapshot, e.g. \"apartment-1br\" or \"villa-4br\".","schema":{"type":"string"}},{"name":"building","in":"query","required":false,"description":"Building name as registered with DLD (apartments), e.g. \"Marina Gate 1\". Optional.","schema":{"type":"string"}},{"name":"months","in":"query","required":false,"description":"","schema":{"type":"integer","minimum":1,"maximum":24,"default":12}},{"name":"limit","in":"query","required":false,"description":"","schema":{"type":"integer","minimum":1,"maximum":10,"default":10}}],"responses":{"200":{"description":"Result. Includes as_of, sources, method_url, abstain, reason, attribution and disclaimer.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid arguments","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"429":{"description":"Rate limit exceeded"}}}},"/areas/{area}/rent":{"get":{"operationId":"estimate_rent","summary":"Rent range","description":"Rent range from new Ejari contracts started in the last 12 months, with n.","parameters":[{"name":"area","in":"path","required":true,"description":"Area name or slug: any of the Dubai areas from list_areas, e.g. \"Dubai Marina\", \"jumeirah-village-circle\", \"JVC\" or \"Jumeirah Park\".","schema":{"type":"string"}},{"name":"segment","in":"query","required":true,"description":"Segment key from get_area_snapshot, e.g. \"apartment-1br\" or \"villa-4br\".","schema":{"type":"string"}}],"responses":{"200":{"description":"Result. Includes as_of, sources, method_url, abstain, reason, attribution and disclaimer.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid arguments","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"429":{"description":"Rate limit exceeded"}}}},"/areas/{area}/trend":{"get":{"operationId":"get_market_trend","summary":"Quarterly market trend","description":"Quarterly sale and rent index for the area.","parameters":[{"name":"area","in":"path","required":true,"description":"Area name or slug: any of the Dubai areas from list_areas, e.g. \"Dubai Marina\", \"jumeirah-village-circle\", \"JVC\" or \"Jumeirah Park\".","schema":{"type":"string"}}],"responses":{"200":{"description":"Result. Includes as_of, sources, method_url, abstain, reason, attribution and disclaimer.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid arguments","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"429":{"description":"Rate limit exceeded"}}}},"/areas/{area}/broker-guides":{"get":{"operationId":"get_broker_guides","summary":"Broker guides","description":"Broker-attributed facts about the area (author BRN, date, source), only those published with the broker's permission.","parameters":[{"name":"area","in":"path","required":true,"description":"Area name or slug: any of the Dubai areas from list_areas, e.g. \"Dubai Marina\", \"jumeirah-village-circle\", \"JVC\" or \"Jumeirah Park\".","schema":{"type":"string"}},{"name":"topic","in":"query","required":false,"description":"Optional topic filter.","schema":{"type":"string"}}],"responses":{"200":{"description":"Result. Includes as_of, sources, method_url, abstain, reason, attribution and disclaimer.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid arguments","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"429":{"description":"Rate limit exceeded"}}}},"/brief-link":{"get":{"operationId":"start_brief","summary":"Prepare a Brief Battle request","description":"Prepares a Brief Battle request: brokers in the area compete for 72 hours with real units, ranked against DLD fair value. Returns a link the buyer opens to confirm and submit; nothing is sent until the buyer confirms.","parameters":[{"name":"area","in":"query","required":true,"description":"Area where Brief Battle runs today: Jumeirah Park, The Springs or The Meadows.","schema":{"type":"string"}},{"name":"property_type","in":"query","required":true,"description":"","schema":{"type":"string","enum":["apartment","villa","townhouse"]}},{"name":"bedrooms","in":"query","required":true,"description":"Minimum bedrooms.","schema":{"type":"integer","minimum":1,"maximum":7}},{"name":"budget_aed","in":"query","required":true,"description":"Maximum budget in AED.","schema":{"type":"integer","minimum":300000,"maximum":200000000}},{"name":"timeline","in":"query","required":false,"description":"","schema":{"type":"string","enum":["asap","3m","6m","12m"]}},{"name":"financing","in":"query","required":false,"description":"","schema":{"type":"string","enum":["cash","mortgage_preapproved","mortgage_planned"]}},{"name":"must_haves","in":"query","required":false,"description":"Free text for brokers. No emails, phone numbers or links.","schema":{"type":"string","maxLength":500}}],"responses":{"200":{"description":"Result. Includes as_of, sources, method_url, abstain, reason, attribution and disclaimer.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid arguments","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"429":{"description":"Rate limit exceeded"}}}}}}