Dubai Market API reference

Quick start

After you subscribe and we confirm your payment, you receive a key for the propdata-ae product. Store it as an environment variable on your server, then:

# 1. Find a DLD registration area ID
curl -s -H "x-api-key: $PROPDATA_AE_KEY" \
  "https://api.dubai.proptechusa.ai/v1/ae/dubai/areas"

# 2. Business Bay (area 526), Ready residential units, yearly
curl -sG "https://api.dubai.proptechusa.ai/v1/ae/dubai/market" \
  -d area_id=526 -d group=area -d period=year -d registration=Ready -d top=100 \
  -H "x-api-key: $PROPDATA_AE_KEY"

# 3. Community index for Business Bay, monthly from January 2026
curl -sG "https://api.dubai.proptechusa.ai/v1/ae/dubai/communities/business-bay/monthly" \
  -d date_from=2026-01 \
  -H "x-api-key: $PROPDATA_AE_KEY"

# 4. Every verified month for Marsa Dubai (area 330), oldest first, 100 per page; follow pagination.next_offset
curl -sG "https://api.dubai.proptechusa.ai/v1/ae/dubai/market" \
  -d area_id=330 -d registration=Ready -d sort=period -d top=100 -d offset=0 \
  -H "x-api-key: $PROPDATA_AE_KEY"

# 5. Rents, yields and bedroom segments (publisher aggregates)
curl -s -H "x-api-key: $PROPDATA_AE_KEY" "https://api.dubai.proptechusa.ai/v1/ae/dubai/rentals/communities"
curl -s -H "x-api-key: $PROPDATA_AE_KEY" "https://api.dubai.proptechusa.ai/v1/ae/dubai/yields/communities"
curl -s -H "x-api-key: $PROPDATA_AE_KEY" "https://api.dubai.proptechusa.ai/v1/ae/dubai/communities/business-bay/bedrooms"

# 6. Project register: one developer's projects under construction, then one project with its capture history
curl -sG "https://api.dubai.proptechusa.ai/v1/ae/dubai/projects" \
  -d developer_number=1002 -d completion_min=1 -d completion_max=99 -d limit=200 \
  -H "x-api-key: $PROPDATA_AE_KEY"
curl -s -H "x-api-key: $PROPDATA_AE_KEY" "https://api.dubai.proptechusa.ai/v1/ae/dubai/projects/3073"

// Node 18+ on your server
const BASE = "https://api.dubai.proptechusa.ai";
async function ae(path) {
  const res = await fetch(BASE + path, { headers: { "x-api-key": process.env.PROPDATA_AE_KEY } });
  const body = await res.json();
  if (!res.ok) throw new Error(`${res.status} ${body.error}${body.reason ? " (" + body.reason + ")" : ""}`);
  return { body, quotaRemaining: res.headers.get("x-ae-quota-remaining") };
}
const { body } = await ae("/v1/ae/dubai/market?area_id=526&group=area&period=year&registration=Ready&top=100");
for (const g of body.data) console.log(g.period, g.sample_count, g.median_sale_price_per_sqm_aed);
console.log(body.freshness.verified_complete_through, body.sources.attribution);

import os, requests

BASE = "https://api.dubai.proptechusa.ai"
s = requests.Session()
s.headers["x-api-key"] = os.environ["PROPDATA_AE_KEY"]

r = s.get(f"{BASE}/v1/ae/dubai/communities", timeout=30)
r.raise_for_status()
doc = r.json()
print(doc["price_unit"], doc["freshness"]["publisher_data_through"])
for c in doc["data"][:5]:
    print(c["community_name"], c["median_price_per_sqft_aed"])

# Walk a full market history: sort=period and follow next_offset until it is None
months, offset = [], 0
while offset is not None:
    page = s.get(f"{BASE}/v1/ae/dubai/market", params={"area_id": "330", "registration": "Ready", "sort": "period", "top": 100, "offset": offset}, timeout=30).json()
    months += [g["period"] for g in page["data"]]
    offset = page["pagination"]["next_offset"]
print(len(months), page["pagination"]["document_complete"])  # every eligible month through the verified date

Authentication

Send your key in the x-api-key header, or as Authorization: Bearer <key>. Keys are issued for the propdata-ae product only; PropData US keys are not accepted.

The OpenAPI document at /v1/ae/openapi.json needs no key.

Datasets

Only propdata-ae-market/1 is computed by PropData; every other contract republishes a publisher's figures with its methodology (statistics_origin: publisher_aggregate_republished). Do not compare them without reading the not_comparable_with and methodology blocks in each response. Project and developer records are joined across publishers only on the registry numbers both publish, never on names, and never to individual sales.

Market statistics

Each row in data

The response also carries scope (the resolved query), sample_rule (including suppressed and excluded row counts), freshness, coverage, limitations, sources and bundle. Prices are decimal strings, so parse them with a decimal type if you need exact arithmetic.

Areas

completeness.status and completeness.verified_through show whether, and up to when, an area was independently verified. Area IDs are registration districts. Area 330, Marsa Dubai, includes JBR and Bluewaters; it is not the Dubai Marina community.

Communities

All values are the publisher's community aggregates (statistics_origin: publisher_aggregate_republished). Rent figures are community summaries, not individual contracts. top_dld_area is the publisher's majority-area field and does not mean the boundaries are equivalent.

Community monthly & yearly

Each month carries sample_flag (the publisher's low-sample marker) and provisional. DLD keeps adding registrations after a month ends, so the latest months can still change.

Rents, yields and bedroom segments

All values are the publisher's aggregates: rents are community or segment summaries of Ejari contracts, never individual tenancies; yields are gross, before service charges, vacancy, fees and financing, and are not a return forecast. Each response carries the publisher's methodology and freshness.publisher_data_through.

Project register

The completion percentage is recorded by a DLD technical inspector and stays constant between inspections. The declared handover date is the date held in the register, not actual completion. No project is linked to an individual sale, unit or title.

Developers

Company records only: no contact details, escrow balances or financial statements.

Sources

Freshness & completeness

Registered-sale responses include a freshness block:

"freshness": {
  "source_data_through": "2025-12-31",
  "verified_complete_through": "2025-12-31",
  "verified_complete_through_basis": "area_community_union",
  "coverage_cutoff_applied": true
}

Months after verified_complete_through are withheld rather than estimated. Current dates: registered sales are verified through 31 Jan 2026 Dubai-wide, and up to 30 Sep 2026 for individually verified areas. Community index responses report publisher_data_through, currently 15 Oct 2026. The dates in each response take precedence over this page.

Every response names its release in bundle.version and bundle.manifest_sha256. Keep these if you need to reproduce a figure later.

Errors

Errors return JSON: {"error": "…", "reason": "…", "detail": "…"}. Only error is always present.

Quotas & limits

The monthly quota is enforced exactly and atomically per key. Successful responses include X-AE-Quota-Remaining. The per-minute guard is approximate and applied per location. Responses also include a Server-Timing header.

The data changes only when a new verified release is published, so cache responses on your side and use bundle.version to tell when to refresh.

Attribution

Both source publishers license their data under CC BY 4.0. Wherever you display or redistribute the data, show the attribution from sources.attribution and the non-endorsement notice from sources.endorsement_notice, link to the licence, and state any further changes you make.

Not provided

The API serves statistics and register records, not property records. It does not provide individual transaction records, unit or property histories, ownership, title or registry records, valuations or appraisals, individual rental (Ejari) contracts, developer contact details or escrow balances, any link from a project or developer to an individual sale, unit or title, parcel boundaries or maps. The project register carries the register's completion percentage and declared handover date, not a construction-progress assessment. Statistics are not investment advice, and gross yields are not return forecasts.

Questions: sales@proptechusa.ai.