🔌 REST API · v1

DXBPROP API Docs

Look up Dubai property owner details by DLD permit number. Simple key-based authentication, JSON responses.

Get API Access → ← Back to Home

Authentication

All API requests must include your API key in the X-API-Key header. You can generate your API key from the DXBPROP Chrome extension → API tab.

Required Header

X-API-Key: dxb_your_api_key_here

Base URL

https://api.dxbprop.ae

Trial Credits

New API accounts include free trial credits. Once exhausted, an active API subscription is required. The credits_remaining field in each response shows how many trial calls you have left (null when on a paid plan).

Endpoints

The DXBPROP API provides two endpoints: property lookup and account status.

POST /v1/lookup

Look up a property by DLD permit number. Returns full property details and owner information from the Dubai Land Department registry.

Request Body

FieldTypeDescription
permit_numberstringThe DLD permit number as shown on the listing (numeric string, e.g. "5318294760")

Example Request

curl -X POST https://api.dxbprop.ae/v1/lookup \ -H "X-API-Key: dxb_your_api_key_here" \ -H "Content-Type: application/json" \ -d '{"permit_number": "5318294760"}'
GET /v1/status

Returns your current API account status: subscription plan, daily/monthly usage, and credits remaining.

Example Request

curl https://api.dxbprop.ae/v1/status \ -H "X-API-Key: dxb_your_api_key_here"

Example Response

{ "subscription": { "status": "active", "plan_name": "DXBPROP API Pro", "plan_code": "api_pro", "daily_limit": 300, "monthly_limit": 9000, "period_end": "2026-05-16", "active": true }, "usage": { "daily_used": 42, "monthly_used": 387 }, "trial_credits_remaining": null // null on paid plan }

Response Schema

A successful POST /v1/lookup returns 200 OK with the following structure:

{ "permit_number": "5318294760", "property": { "location": { "area": "Al Furjan", "project": "AZIZI PLAZA", "master_project": "Al Furjan" }, "info": { "property_number": "333", "type": "Unit", "sub_type": "Apartment", "rooms": "2 B/R", "area_sqm": 84.53, "land_number": "334", "land_sub_number": "0", "freehold": true, "municipality_code": "DXB-123", "municipality_number": "0", "dewa_number": "591064260" } }, "owners": [ { "name": "A***** Al R*****", "mobile": "+971 5X XXX XXXX", "email": "a*****@gmail.com" } ], "credits_remaining": null // null on paid plan; integer on trial }

Response Fields

FieldTypeDescription
permit_numberstringThe permit number as submitted in the request
property.location.areastringDLD area name (e.g. "Dubai Marina")
property.location.projectstringBuilding / project name
property.location.master_projectstringMaster community name
property.info.property_numberstringUnit number within the building
property.info.typestringProperty type (Unit, Villa, etc.)
property.info.sub_typestringProperty sub-type (Apartment, Townhouse, etc.)
property.info.roomsstringRoom configuration (e.g. "2 B/R")
property.info.area_sqmnumberFloor area in square meters
property.info.freeholdbooleanWhether the property is freehold
property.info.dewa_numberstringDEWA utility account number for the unit
ownersarrayList of registered owners with name, mobile, and email
credits_remaininginteger | nullRemaining trial credits. null when on a paid subscription

Error Codes

The API uses standard HTTP status codes. Error responses include a detail field describing the issue.

StatusMeaningCommon Cause
401 Unauthorized Missing or invalid X-API-Key
402 Payment Required No active subscription and no trial credits remaining. Subscribe here.
404 Not Found No property found for the given permit number in the DLD database
422 Validation Error Missing or malformed request body (e.g. permit_number not provided)
429 Rate Limited Daily or monthly API call limit reached for your plan
502 Bad Gateway Upstream DLD owner service unavailable (retry after a few seconds)
// Example 401 response { "detail": "Invalid API key" } // Example 402 response { "detail": "No active API subscription or trial credits remaining. Subscribe at https://api.dxbprop.ae/api-subscribe" }

Ready to Integrate?

Get your API key and start making lookups in minutes. Trial credits included on every new account.

Get API Access →