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_XXXXXXXXXXXXEndpoints
| POST | /api/v1/listings | Create or update listings. |
| GET | /api/v1/listings | List your submitted listings + status. |
| GET | /api/v1/listings/{externalId} | Fetch one of your listings. |
| DELETE | /api/v1/listings/{externalId} | Withdraw a listing. |
Listing fields
| Field | Type | Notes | |
|---|---|---|---|
| externalId | string | required | Your unique id for this listing. Used to update/withdraw it later. |
| title | string | required | Listing headline. |
| type | string | required | villa | apartment | penthouse | townhouse | unit | land |
| dealType | string | optional | sale (default) or rent. |
| country | string | optional | ISO-3166 alpha-2 country code, e.g. 'AE', 'GB', 'SA'. Defaults to AE. |
| price | { amount } | optional | Native price, e.g. { currency: 'GBP', amount: 450000 }. Or send priceAed. |
| currency | string | optional | ISO currency code, e.g. 'AED', 'GBP', 'USD'. Defaults to AED (or price.currency). |
| priceAed | number | optional | Price in AED (shortcut when the listing is in AED). |
| bedrooms | number | optional | Bedroom count (0 = studio). |
| bathrooms | number | optional | Bathroom count. |
| areaSqft | number | optional | Built-up area in sqft. |
| community | string | optional | Community / area name, e.g. 'Dubai Marina'. Matched to our catalog. |
| developer | string | optional | Developer name, e.g. 'Emaar'. Matched to our records. |
| offPlan | boolean | optional | true for off-plan; false for ready/completed. |
| handoverDate | string | optional | Handover date, e.g. '2027-06-30'. |
| furnished | boolean | optional | Furnished? |
| waterfront | boolean | optional | Waterfront? |
| description | string | optional | Full description. |
| images | string[] | optional | Public image URLs (first becomes the cover). Max 40. |
| amenities | string[] | optional | Amenity names, e.g. ['Gym','Pool']. |
| latitude | number | optional | Decimal latitude. |
| longitude | number | optional | Decimal longitude. |
| contact | object | optional | Your 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.