Happy Endpoint

Get property transaction history

Get historical property transaction data (sales and rentals) for Dubai/UAE. Filter by purpose, category, location, completion status, time period, bedrooms, price range, and area. Useful for market analysis and pricing trends.

GET
/transactions

Authorization

RapidApiKey
X-RapidAPI-Key<token>

In: header

Query Parameters

purpose*string
  • Transaction type
  • for-sale — sale transactions
  • for-rent — rental transactions
Value in"for-sale" | "for-rent"
page?integer
  • Page number (starts from 1)
  • Results per page: 20
Default1
Range1 <= value
category_ids?string
  • Comma-separated category names or external IDs
  • Names: residential, commercial, apartments, villas, townhouses, penthouse, offices, shops, etc.
  • Or external IDs: 1 (residential), 2 (commercial), 4 (apartments), 3 (villas)
  • Example: apartments,villas,townhouses or 4,3,16
location_ids?string
  • Comma-separated location external IDs from /autocomplete
completion_status?string
  • Filter by completion status
Default"any"
Value in"any" | "completed" | "under-construction"
time_period?string
  • Time period for transaction data
  • 1m — last 1 month
  • 3m — last 3 months
  • 6m — last 6 months
  • 12m — last 12 months (default)
  • 24m — last 24 months
Default"12m"
Value in"1m" | "3m" | "6m" | "12m" | "24m"
beds?string
  • Comma-separated bedrooms filter
  • 0 = Studio
price_min?integer
  • Minimum price in AED
Range0 <= value
price_max?integer
  • Maximum price in AED
Range0 <= value
area_min?number
  • Minimum area in sqft
Range0 <= value
area_max?number
  • Maximum area in sqft
Range0 <= value
sort_by?string
  • Sort order for transactions
  • date_desc — newest first (default)
  • date_asc — oldest first
  • price_desc — highest price first
  • price_asc — lowest price first
  • area_desc — largest area first
  • area_asc — smallest area first
Default"date_desc"
Value in"date_desc" | "date_asc" | "price_desc" | "price_asc" | "area_desc" | "area_asc"

Header Parameters

X-RapidAPI-Host*string
Default"bayut14.p.rapidapi.com"

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/transactions?purpose=for-sale" \  -H "X-RapidAPI-Host: bayut14.p.rapidapi.com"
{
  "success": true,
  "data": null
}
{
  "success": false,
  "message": "Invalid request: Missing required parameter",
  "error": "VALIDATION_ERROR"
}
{
  "success": false,
  "message": "Internal server error. Please try again later.",
  "error": "INTERNAL_ERROR"
}
{
  "success": false,
  "message": "Service temporarily unavailable. Please try again later.",
  "error": "API_ERROR"
}