← Home
Get Properties
Get Properties
This endpoint lists properties based of the given filters.
🔐 Bearer Token: Provide your bearer token in the Authorization header when making requests to protected resources.
Query Parameters
| Name | Type | Required | Description | Example |
|---|---|---|---|---|
| per_page | string | Optional | The number of results per page. | 10 |
| bayut_state | string | Optional | The state of property onbayut, properties with matching state on Bayut will be returned. | active |
| dubizzle_state | string | Optional | The state of property ondubizzle, properties with matching state on Dubizzle will be returned. | active |
| user_id | string | Optional | The user filter, properties for this user will be returned. | 2113494 |
| agency_id | string | Optional | The agency filter, properties belong to agency ID will be returned. | 112002 |
| category_id | string | Optional | The category filter, properties with matching category ID will be returned. | |
| location_id | string | Optional | The location filter, properties with matching location ID will be returned. | 14736 |
| min_price | string | Optional | The minimum price filter, properties greater than this value would be returned. | 15000 |
| max_price | string | Optional | The maximum price filter, properties lesser than this value would be returned. | 20000 |
| reference | string | Optional | The reference number filter, property with matching reference number will be returned. |
Response Schema
| Name | Type | Required | Description | Example |
|---|---|---|---|---|
| data | object | Optional | Detailed representation of a property resource. | |
| id | integer | Optional | Unique identifier of the property. | 95 |
| title | object | Optional | Localized title of the property. | |
| description | object | Optional | Localized description of the property. | |
| bedrooms | integer | Optional | Number of bedrooms in the property. | |
| bathrooms | integer | Optional | Number of bathrooms in the property. | |
| area | number | Optional | Built-up area of the property. | |
| area_unit | string | Optional | Measurement unit for area. Default: sqft | sqft |
| price | number | Optional | Price of the property. | |
| purpose | object | Optional | Localized purpose of the property (e.g. For Sale / For Rent). | |
| category | object | Optional | Property category and parent classification. | |
| rental_details | object | Optional | ||
| sale_details | object | Optional | ||
| furnishing_status | enum<string> | Optional | ||
| completion_status | enum<string> | Optional | ||
| completion_date | string | Optional | ||
| offplan_details | object | Optional | ||
| coordinates | object | Optional | Geographical coordinates of the property. | |
| comment | string | Optional | Internal or moderation comment. | |
| verification_state | enum<string> | Optional | ||
| permit | object | Optional | Permit details, shown when permit relation is loaded. | |
| location | Optional | Unique identifier of the property. | 95 | |
| images | array[object] | Optional | ||
| videos | array[object] | Optional | ||
| portals | array[object] | Optional | ||
| amenities | array[object] | Optional | ||
| user_detail | Optional | Unique identifier of the property. | 95 | |
| created_at | string | Optional | ||
| updated_at | string | Optional | ||
| links | object | Optional | The links to pages. | |
| first | string | Optional | The link to first page. | |
| last | string | Optional | The link to last page. | |
| prev | string | Optional | The link to previous page. | |
| next | string | Optional | The link to next page. | |
| meta | object | Optional | Meta about pagination data. | |
| current_page | integer | Optional | The page you are currently on. | |
| from | integer | Optional | The first page of the paginated results. | |
| path | string | Optional | The path of the current page. | |
| to | integer | Optional | The last page of the paginated results. | |
| total | integer | Optional | The total number of results. |
Responses
200✅
401⚠️
403⚠️
Code Examples
curl --location 'https://api.bayut.com/v1/properties?per_page=10&bayut_state=active&dubizzle_state=active&user_id=2113494&agency_id=112002&category_id=&location_id=14736&min_price=15000&max_price=20000&reference=undefined' \
--header 'Authorization: Bearer <token>'{
"data": [
{
"id": 7950859,
"reference": "102917-BbUwMm",
"title": {
"en": "villa",
"ar": null
},
"description": {
"en": "villa",
"ar": null
},
"bedrooms": 2,
"bathrooms": 2,
"area": 6499,
"area_unit": "sqft",
"price": 15000,
"purpose": {
"en": "For Sale",
"ar": "\u0644\u0644\u0628\u06cc\u0639"
},
"category": {
"id": 3,
"title": {
"en": "Villa",
"ar": "\u0641\u06cc\u0644\u0627"
},
"parent_title": "Residential"
},
"sale_details": {
"financing_available": null,
"financing_institute": null
},
"furnishing_status": null,
"completion_status": "completed",
"completion_date": null,
"offplan_details": {
"sale_type": null,
"dld_waiver": null,
"original_price": null,
"amount_paid": null
},
"coordinates": {
"latitude": 31.527557363256243,
"longitude": 74.35022725756896
},
"comment": null,
"verification_state": "checked",
"permit": {
"number": null,
"status": null,
"comment": "Compliance status is Pending our team's review"
},
"location": {
"id": 14736,
"title": {
"en": "Mudfak",
"ar": "\u0627\u0644\u0645\u062f\u0641\u0642"
},
"breadcrumb": {
"en": [
"UAE",
"Ras Al Khaimah",
"Mudfak"
],
"ar": [
"\u0627\u0644\u0625\u0645\u0627\u0631\u0627\u062a",
"\u0631\u0623\u0633 \u0627\u0644\u062e\u064a\u0645\u0629",
"\u0627\u0644\u0645\u062f\u0641\u0642"
]
},
"coordinates": {
"latitude": 25.588080222539,
"longitude": 55.959356863772
}
},
"images": [
{
"url": "https:\/\/assets.bayut.com\/listing-images\/rYoxkrs3PV1BGTaGmA4KOJwyPQqqsV6LrUsNUUMg",
"is_main": true
}
],
"videos": [],
"portals": [
{
"id": 1,
"name": "bayut",
"state": "active",
"published_at": "2025-06-20T11:18:25.000000Z",
"refreshed_at": "2025-10-12T20:00:04.000000Z",
"ad_products": [
{
"id": 77,
"name": "hot",
"alias": {
"l1": "Hot 7 days",
"l2": null
},
"expires_at": "2025-10-20 23:59:59",
"auto_renew": 1,
"created_at": "2025-05-02 15:00:41",
"updated_at": "2025-10-13 00:00:04"
}
]
},
{
"id": 2,
"name": "dubizzle",
"state": "active",
"published_at": "2025-06-20T11:18:25.000000Z",
"refreshed_at": "2025-09-26T20:07:02.000000Z",
"ad_products": []
}
],
"amenities": [],
"user_detail": {
"id": 2113494,
"name": {
"en": "LakeCity OWNER",
"ar": "lake city"
},
"about": "Local Exporting",
"gender": "male",
"image": "https:\/\/assets.stage.bayut.sector.run\/agents\/9XZteAidMYN2iWEgUj9YhAHk0MyYlDHOvOAA2ZFY",
"experience_in_years": "5",
"brn_number": "58185",
"bln_number": null,
"contact": {
"email": "lakecityrealestate@mail.com",
"phone": "+971-4-6666527",
"cell": "+971-12-1111113",
"whatsapp": "+971-4-6666527"
}
},
"created_at": "2023-09-19T13:59:51.000000Z",
"updated_at": "2025-10-17T11:37:05.000000Z"
},
{
"id": 11026039,
"reference": "102917-r9ncRS",
"title": {
"en": "test",
"ar": ""
},
"description": {
"en": "test<br>",
"ar": ""
},
"bedrooms": 3,
"bathrooms": 2,
"area": 122,
"area_unit": "sqft",
"price": 18000,
"purpose": {
"en": "For Rent",
"ar": "\u0644\u0644\u0627\u06cc\u062c\u0627\u0631"
},
"category": {
"id": 4,
"title": {
"en": "Apartments",
"ar": "\u0634\u0642\u0629"
},
"parent_title": "Residential"
},
"rental_details": {
"occupancy_status": null,
"rent_frequency": "weekly",
"minimum_contract_period": null,
"vacating_notice_period": 0,
"maintenance_fee": null,
"maintenance_fee_paid_by": null
},
"furnishing_status": null,
"completion_status": "completed",
"completion_date": null,
"offplan_details": {
"sale_type": null,
"dld_waiver": null,
"original_price": null,
"amount_paid": null
},
"comment": null,
"verification_state": null,
"permit": {
"number": null,
"status": null
},
"location": {
"id": 14736,
"title": {
"en": "Mudfak",
"ar": "\u0627\u0644\u0645\u062f\u0641\u0642"
},
"breadcrumb": {
"en": [
"UAE",
"Ras Al Khaimah",
"Mudfak"
],
"ar": [
"\u0627\u0644\u0625\u0645\u0627\u0631\u0627\u062a",
"\u0631\u0623\u0633 \u0627\u0644\u062e\u064a\u0645\u0629",
"\u0627\u0644\u0645\u062f\u0641\u0642"
]
},
"coordinates": {
"latitude": 25.588080222539,
"longitude": 55.959356863772
}
},
"images": [
{
"url": "https:\/\/assets.stage.bayut.sector.run\/listing-images\/zAWwZdliAgPeWe1LoNfWNZHn4xAZTqLvUmrYzffd",
"is_main": true
}
],
"videos": [],
"portals": [
{
"id": 1,
"name": "bayut",
"state": "active",
"published_at": "2025-07-08T10:56:32.000000Z",
"refreshed_at": "2025-10-10T20:05:05.000000Z",
"ad_products": []
},
{
"id": 2,
"name": "dubizzle",
"state": "active",
"published_at": "2025-07-08T10:56:32.000000Z",
"refreshed_at": "2025-10-10T20:05:18.000000Z",
"ad_products": []
}
],
"amenities": [
{
"id": 4,
"title": {
"en": "Barbeque Area",
"ar": "\u0645\u0643\u0627\u0646 \u0645\u062e\u0635\u0635 \u0644\u0644\u0634\u0648\u0627\u0621"
},
"value": "1"
},
{
"id": 36,
"title": {
"en": "Lawn or Garden",
"ar": "\u062d\u062f\u064a\u0642\u0629"
},
"value": "1"
}
],
"user_detail": {
"id": 2113494,
"name": {
"en": "LakeCity OWNER",
"ar": "lake city"
},
"about": "Local Exporting",
"gender": "male",
"image": "https:\/\/assets.stage.bayut.sector.run\/agents\/9XZteAidMYN2iWEgUj9YhAHk0MyYlDHOvOAA2ZFY",
"experience_in_years": "5",
"brn_number": "58185",
"bln_number": null,
"contact": {
"email": "lakecityrealestate@mail.com",
"phone": "+971-4-6666527",
"cell": "+971-12-1111113",
"whatsapp": "+971-4-6666527"
}
},
"created_at": "2025-03-17T11:26:26.000000Z",
"updated_at": "2025-10-17T11:37:05.000000Z"
}
],
"links": {
"first": "https:\/\/nova.bayut.sector.run\/v1\/properties?page=1",
"last": null,
"prev": null,
"next": null
},
"meta": {
"current_page": 1,
"from": 1,
"path": "https:\/\/nova.bayut.sector.run\/v1\/properties",
"per_page": "10",
"to": 2,
"total": 2
}
}