# DM Global

> A luxury real-estate portal for the UAE with an AI-native data layer. The
> inventory is exposed as a canonical, queryable API so AI agents can read and
> reason over it directly — not only through the website.

## For AI agents (agent-to-agent)

- [Agent Card](https://dmglobal.me/.well-known/agent-card.json): A2A identity, skills, endpoints and supported locations
- A2A endpoint: POST https://dmglobal.me/api/a2a (JSON-RPC 2.0, method "message/send"). Send a text part ("2 bed in Dubai Marina under 3M") or a data part {"skill": "<id>", "params": {...}}. Skills: property-search, property-details, project-search, developer-profiles, market-insights, locations, latest-updates, sourcing-request, agent-directory.
- Not listed here? If nothing matches, send the buyer's name, phone or email and specific requirements with the "sourcing-request" skill; the DM Global team sources it from the market and contacts them.
- Identify yourself with an X-Agent-Id header (or message.metadata.agentId) so repeat queries are recognised.

## Data layer (canonical API)

- [API index](https://dmglobal.me/api/v1): discovery document and endpoint map
- [OpenAPI spec](https://dmglobal.me/api/v1/openapi.json): machine-readable API contract
- [API documentation](https://dmglobal.me/api-docs): human-readable guide

## Endpoints

- GET https://dmglobal.me/api/v1/search — natural-language or structured search (q, type, community, developer, minBedrooms, minPrice, maxPrice, offPlan); returns interpreted intent + ranked matches
- GET https://dmglobal.me/api/v1/properties — list properties (filters: type, community, developer, minBedrooms, minPrice, maxPrice, offPlan, limit, offset)
- GET https://dmglobal.me/api/v1/properties/{slug} — full property with its entity graph
- GET https://dmglobal.me/api/v1/projects — off-plan projects
- GET https://dmglobal.me/api/v1/projects/{slug} — one project (off-plan development)
- GET https://dmglobal.me/api/v1/developers — developers
- GET https://dmglobal.me/api/v1/developers/{slug} — one developer with their listings
- GET https://dmglobal.me/api/v1/communities — communities with nearby landmarks
- GET https://dmglobal.me/api/v1/communities/{slug} — one community with its listings
- GET https://dmglobal.me/api/v1/locations — cities and communities directory
- GET https://dmglobal.me/api/v1/market?community={name}&bedrooms={n} — recorded sale/rent transactions and price trend for a community
- GET https://dmglobal.me/api/v1/updates?since={date} — listings added or changed since a date

## Entity graph

developer → project → property → unit → amenities → community (location) → nearby landmarks (schools, metro stations)

Each property detail page also embeds schema.org JSON-LD, and the site publishes a sitemap at https://dmglobal.me/sitemap.xml.