DM GlobalLuxury
← API overview

For partner companies

Partner Listing API

Submit your property listings to the DM Global portal programmatically. You send us listings; we review and publish them. Each listing is keyed by your own externalId, so re-sending the same id updates the existing listing instead of creating a duplicate.

Authentication

DM Global issues you a secret API key. Send it on every request in the Authorization header (or X-API-Key). Keep it server-side; never expose it in a browser. To get a key, contact DM Global.

Authorization: Bearer dmg_partner_XXXXXXXXXXXX

Endpoints

POST/api/v1/listingsCreate or update listings.
GET/api/v1/listingsList your submitted listings + status.
GET/api/v1/listings/{externalId}Fetch one of your listings.
DELETE/api/v1/listings/{externalId}Withdraw a listing.

Listing fields

FieldTypeNotes
externalIdstringrequiredYour unique id for this listing. Used to update/withdraw it later.
titlestringrequiredListing headline.
typestringrequiredvilla | apartment | penthouse | townhouse | unit | land
dealTypestringoptionalsale (default) or rent.
countrystringoptionalISO-3166 alpha-2 country code, e.g. 'AE', 'GB', 'SA'. Defaults to AE.
price{ amount }optionalNative price, e.g. { currency: 'GBP', amount: 450000 }. Or send priceAed.
currencystringoptionalISO currency code, e.g. 'AED', 'GBP', 'USD'. Defaults to AED (or price.currency).
priceAednumberoptionalPrice in AED (shortcut when the listing is in AED).
bedroomsnumberoptionalBedroom count (0 = studio).
bathroomsnumberoptionalBathroom count.
areaSqftnumberoptionalBuilt-up area in sqft.
communitystringoptionalCommunity / area name, e.g. 'Dubai Marina'. Matched to our catalog.
developerstringoptionalDeveloper name, e.g. 'Emaar'. Matched to our records.
offPlanbooleanoptionaltrue for off-plan; false for ready/completed.
handoverDatestringoptionalHandover date, e.g. '2027-06-30'.
furnishedbooleanoptionalFurnished?
waterfrontbooleanoptionalWaterfront?
descriptionstringoptionalFull description.
imagesstring[]optionalPublic image URLs (first becomes the cover). Max 40.
amenitiesstring[]optionalAmenity names, e.g. ['Gym','Pool'].
latitudenumberoptionalDecimal latitude.
longitudenumberoptionalDecimal longitude.
contactobjectoptionalYour listing contact details (kept internal).

Example — submit

curl -X POST https://dmglobal.me/api/v1/listings \
  -H "Authorization: Bearer dmg_partner_XXXX" \
  -H "Content-Type: application/json" \
  -d '{
    "listings": [
      {
        "externalId": "SKY-1042",
        "title": "2BR with full marina view",
        "type": "apartment",
        "dealType": "sale",
        "price": { "currency": "AED", "amount": 2650000 },
        "bedrooms": 2,
        "bathrooms": 2,
        "areaSqft": 1180,
        "community": "Dubai Marina",
        "developer": "Emaar",
        "offPlan": false,
        "description": "High-floor 2-bed with panoramic views...",
        "images": ["https://cdn.example.com/sky1042/1.jpg"],
        "amenities": ["Gym", "Pool", "Covered Parking"]
      }
    ]
  }'

Response

{
  "partner": "Skyline Realty LLC",
  "summary": { "received": 1, "created": 1, "updated": 0, "failed": 0 },
  "note": "Submissions are saved as DRAFT and go live after DM Global review.",
  "results": [
    {
      "externalId": "SKY-1042",
      "action": "created",
      "status": "DRAFT",
      "url": "https://dmglobal.me/properties/2br-with-full-marina-view"
    }
  ]
}

Countries & currency

Listings can be from any country. Send country (ISO-2) and the native currency with the price. We display the price in its own currency and also store an AED-normalized value so cross-country sorting and price filters work. Omit them and the listing defaults to AE / AED.

Review & status

Every submission lands as DRAFT and is published by DM Global after review. Check status anytime with GET /api/v1/listings. Status values: DRAFT (pending), ACTIVE (live), OFF_MARKET (withdrawn). Re-submitting an existing externalId updates the listing and keeps its current status (an approved listing won’t revert to draft).

Errors

Errors return JSON as { "error": { "status", "message" } }. Per-listing validation errors appear in the results array (that listing is skipped; valid ones still process). Common statuses: 401 bad key, 400 malformed body, 422 every listing failed validation.

Need a key or have questions? Contact DM Global.