Show more

Use to navigate results, ENTER to select one, ESC to close

Type in any word to easily find the endpoint, property or group of operations you are looking for.

API changelog
Download source
  • JSON OpenAPI specification
  • YAML OpenAPI specification
Hotel Booking System

Topics

  • Introduction
  • Authentication

Endpoints

  • Bookings
    • Get a booking by its id GET
    • Delete a booking DELETE
    • Get an invoice by booking id GET
    • Create a new booking POST
    • Retrieve a booking invoice as a PDF file, to download or print GET
  • Cities
    • Get a city by its id GET
    • Update a city PUT
    • Delete a city DELETE
    • Retrieves a list of cities based on the specified query parameters. GET
    • Create a new city POST
    • Returns TOP N most visited cities, N is 5 by default GET
    • Upload an image to a city POST
  • Guests
    • Retrieves a collection of unique recently visited hotels for a guest, presenting essential details. GET
    • Retrieves a collection of unique recently visited hotels for a the current authorized guest, presenting essential details. GET
  • Hotels
    • Get a hotel by its id GET
    • Update a hotel PUT
    • Delete a hotel DELETE
    • Retrieves a list of hotels based on the specified query parameters. GET
    • Create a new hotel POST
    • Upload an image to a hotel POST
    • Searches and filters hotels based on the specified criteria. GET
    • Retrieves the reviews for a specific hotel based on the specified query parameters. GET
    • Adds a review for a specific hotel. POST
    • Get a review by its id GET
    • Update a review PUT
    • Delete a review DELETE
    • Get hotel average rating GET
  • Login
    • Login a user POST
  • Register
    • Register a guest POST
  • Register admin
    • Register an admin POST
  • Rooms
    • Create a new discount POST
    • Get a discount by its id GET
    • Delete a discount DELETE
    • Retrieves a collection of featured deals based on the specified count. GET
    • Get a room by its id GET
    • Update a room PUT
    • Delete a room DELETE
    • Retrieves a list of rooms based on the specified query parameters. GET
    • Create a new room POST
    • Upload an image to a room POST
Powered by Bump.sh
API changelog
Download source
  • JSON OpenAPI specification
  • YAML OpenAPI specification
Hotel Booking System

Returns TOP N most visited cities, N is 5 by default

Ask AI
  • Open in ChatGPT
  • Open in Claude

  • View as Markdown
  • Copy as Markdown
GET /api/Cities/trending-destinations

This endpoint allows clients to retrieve a curated list of trending destinations, specifically the topmost visited cities. The response includes essential details for each city, such as its unique identifier, name, and a visually appealing thumbnail.

The number of trending destinations to be retrieved can be specified using the count parameter. If no count is provided, the default is set to 5.

Sample request:

GET /trending-destinations?count=3

Query parameters

  • count integer(int32)

    The number of trending destinations to retrieve. Default is 5.

    Default value is 5.

Responses

  • 200
    text/plain
    text/plain application/json text/json

    Returns TOP N most visited cities, N is 5 by default

    Hide response attributes Show response attributes object
    • id string(uuid)
    • name string | null
    • country string | null
    • cityImage object
      Hide cityImage attributes Show cityImage attributes object
      • imageUrl string | null
      • alternativeText string | null
      • Additional properties are NOT allowed
    • Additional properties are NOT allowed
    Hide response attributes Show response attributes object
    • id string(uuid)
    • name string | null
    • country string | null
    • cityImage object
      Hide cityImage attributes Show cityImage attributes object
      • imageUrl string | null
      • alternativeText string | null
      • Additional properties are NOT allowed
    • Additional properties are NOT allowed
    Hide response attributes Show response attributes object
    • id string(uuid)
    • name string | null
    • country string | null
    • cityImage object
      Hide cityImage attributes Show cityImage attributes object
      • imageUrl string | null
      • alternativeText string | null
      • Additional properties are NOT allowed
    • Additional properties are NOT allowed
GET /api/Cities/trending-destinations
curl \
 -X GET http://api.example.com/api/Cities/trending-destinations \
 -H "Authorization: Bearer $ACCESS_TOKEN"
Response examples (200)
[
  {
    "id": "string",
    "name": "string",
    "country": "string",
    "cityImage": {
      "imageUrl": "string",
      "alternativeText": "string"
    }
  }
]
Response examples (200)
[
  {
    "id": "string",
    "name": "string",
    "country": "string",
    "cityImage": {
      "imageUrl": "string",
      "alternativeText": "string"
    }
  }
]