← Home
Get Categories
Get Categories
This endpoint lists categories of property to be used in create/update properties endpoints.
🔐 Bearer Token: Provide your bearer token in the Authorization header when making requests to protected resources.
Query Parameters
| Name | Type | Required | Description | Example |
|---|---|---|---|---|
| title | string | Optional | The title filter, categori(es) with matching title would be returned. | Residential |
| per_page | string | Optional | The number of results per page. | 25 |
Response Schema
| Name | Type | Required | Description | Example |
|---|---|---|---|---|
| data | object | Optional | Represents a property category such as Residential, Commercial, or specific subtypes (e.g., Apartment, Villa). | |
| id | integer | Optional | The unique identifier for the category. | 4 |
| name | object | Optional | The localized names of the category in English and Arabic. | |
| slug | string | Optional | The SEO-friendly slug identifier for the category (maps totype_htaccessin the database). | apartments |
| subCategories | array | Optional | The list of subcategories belonging to this category. Returned only ifchildrenrelationship is loaded. | |
| 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✅
403⚠️
401⚠️
Code Examples
curl --location 'https://api.bayut.com/v1/categories?title=Residential&per_page=25' \
--header 'Authorization: Bearer <token>'{
"data": [
{
"id": 1,
"name": {
"en": "Residential",
"ar": "سكني"
},
"slug": "residential",
"subCategories": [
{
"id": 3,
"name": {
"en": "Villa",
"ar": "فیلا"
},
"slug": "villas"
},
{
"id": 4,
"name": {
"en": "Apartments",
"ar": "شقة"
},
"slug": "apartments"
},
{
"id": 12,
"name": {
"en": "Residential Floor",
"ar": "طابق سكني"
},
"slug": "residential-floor"
},
{
"id": 14,
"name": {
"en": "Residential Plot",
"ar": "ارض سكنية"
},
"slug": "residential-plots"
},
{
"id": 16,
"name": {
"en": "Townhouse",
"ar": "تاون هاوس"
},
"slug": "townhouses"
},
{
"id": 17,
"name": {
"en": "Residential Building",
"ar": "مبنى سكني"
},
"slug": "residential-building"
},
{
"id": 18,
"name": {
"en": "Penthouse",
"ar": "بنتهاوس"
},
"slug": "penthouse"
},
{
"id": 19,
"name": {
"en": "Villa Compound",
"ar": "فيلا مجمع سكني"
},
"slug": "villa-compound"
},
{
"id": 21,
"name": {
"en": "Hotel Apartments",
"ar": "شقة فندقية"
},
"slug": "hotel-apartments"
}
]
},
{
"id": 2,
"name": {
"en": "Commercial",
"ar": "تجاري"
},
"slug": "commercial",
"subCategories": [
{
"id": 5,
"name": {
"en": "Offices",
"ar": "مکتب"
},
"slug": "offices"
},
{
"id": 6,
"name": {
"en": "Shops",
"ar": "محل تجاري"
},
"slug": "shops"
},
{
"id": 7,
"name": {
"en": "Warehouse",
"ar": "مستودع"
},
"slug": "warehouses"
},
{
"id": 8,
"name": {
"en": "Factory",
"ar": "مصنع"
},
"slug": "factories"
},
{
"id": 9,
"name": {
"en": "Labour Camp",
"ar": "سكن عمال"
},
"slug": "labour-camps"
},
{
"id": 10,
"name": {
"en": "Commercial Building",
"ar": "مبنی تجاري"
},
"slug": "commercial-buildings"
},
{
"id": 11,
"name": {
"en": "Other Commercial",
"ar": "عقارات تجارية اخرى"
},
"slug": "commerical-properties"
},
{
"id": 13,
"name": {
"en": "Commercial Floor",
"ar": "طابق تجاري"
},
"slug": "commercial-floor"
},
{
"id": 15,
"name": {
"en": "Commercial Plot",
"ar": "ارض تجارية"
},
"slug": "commercial-plots"
},
{
"id": 20,
"name": {
"en": "Bulk Units",
"ar": "مجمع سكني"
},
"slug": "bulk-units"
},
{
"id": 22,
"name": {
"en": "Industrial Land",
"ar": "ارض صناعية"
},
"slug": "industrial-land"
},
{
"id": 23,
"name": {
"en": "Mixed Use Land",
"ar": "ارض استخدام متعدد"
},
"slug": "mixed-use-land"
},
{
"id": 24,
"name": {
"en": "Showroom",
"ar": "معرض تجاري"
},
"slug": "showrooms"
},
{
"id": 25,
"name": {
"en": "Commercial Villa",
"ar": "فيلا تجارية"
},
"slug": "commercial-villas"
}
]
}
]
}