Retrieves a list of all active emirates in the UAE with their English and Arabic names.

Request

• Method: GET
• Parameters: None
• Headers: None required

Response

• Status Code: 200 OK
• Content-Type: application/json

Response Body

[
  {
    "id": 1,
    "emirateName": "Dubai",
    "emirateNameArabic": "دبي"
  },
  {
    "id": 2,
    "emirateName": "Abu Dhabi",
    "emirateNameArabic": "أبو ظبي"
  }
]

Response Fields

• id (integer): Unique identifier for the emirate
• emirateName (string): English name of the emirate
• emirateNameArabic (string): Arabic name of the emirate

Possible Responses

• 200 OK: Successfully retrieved list of emirates (may be empty array if no emirates exist)

Retrieves a list of all active areas for a specific emirate by emirate ID. This endpoint also increments the request count for the emirate.

Request

• Method: GET
• Parameters:
  • id (integer, path parameter): The unique identifier of the emirate
• Headers: None required

Response

• Status Code: 200 OK
• Content-Type: application/json

Response Body

[
  {
    "name": "Downtown Dubai",
    "nameArabic": "وسط مدينة دبي"
  },
  {
    "name": "Marina",
    "nameArabic": "مارينا"
  }
]

Response Fields

• name (string): English name of the area
• nameArabic (string): Arabic name of the area

Possible Responses

• 200 OK: Successfully retrieved list of areas (may be empty array if no areas exist for the emirate)
• Note: The emirate's request count is incremented automatically when this endpoint is called

Example Request

Retrieves a list of all active areas for a specific emirate by searching for the emirate's English or Arabic name. The search is case-insensitive. This endpoint also increments the request count for the emirate.

Request

• Method: GET
• Parameters:
  • name (string, query parameter, required): The English or Arabic name of the emirate
• Headers: None required

Response

• Status Code: 200 OK
• Content-Type: application/json

Response Body

[
  {
    "name": "Downtown Dubai",
    "nameArabic": "وسط مدينة دبي"
  },
  {
    "name": "Marina",
    "nameArabic": "مارينا"
  }
]

Response Fields

• name (string): English name of the area
• nameArabic (string): Arabic name of the area

Possible Responses

• 200 OK: Successfully retrieved list of areas for the emirate (may be empty array if no areas exist)
• 400 Bad Request: When the name parameter is missing or empty

  {
    "message": "Emirate name is required"
  }

• 404 Not Found: When the emirate with the given name is not found

  {
    "message": "Emirate not found"
  }

• Note: The emirate's request count is incremented automatically when this endpoint is called successfully

Example Requests