---
updatedAt: 2026-04-30T10:24:55.000Z
agentTools:
  projectIndex: https://booking-api-docs.guesty.com/llms.txt
---

# Get all the listings included in the booking engine

This call returns the list of listings connected to the requester Booking Engine API instance in Guesty and filtered by given parameters.

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "paths": {
    "/api/listings": {
      "get": {
        "operationId": "getApplicationListingsList",
        "summary": "Get all the listings included in the booking engine",
        "description": "This call returns the list of listings connected to the requester Booking Engine API instance in Guesty and filtered by given parameters.",
        "parameters": [
          {
            "description": "The minimum value of listing occupancy",
            "required": false,
            "name": "minOccupancy",
            "in": "query",
            "schema": {
              "example": 1,
              "type": "integer"
            }
          },
          {
            "description": "The minimum amount of listing bedrooms",
            "required": false,
            "name": "numberOfBedrooms",
            "in": "query",
            "schema": {
              "default": 0,
              "example": 1,
              "type": "integer"
            }
          },
          {
            "description": "The minimum amount of listing bathrooms",
            "required": false,
            "name": "numberOfBathrooms",
            "in": "query",
            "schema": {
              "default": 0,
              "example": 1,
              "type": "integer"
            }
          },
          {
            "description": "The listing property type.",
            "required": false,
            "name": "propertyType",
            "in": "query",
            "schema": {
              "example": "APARTMENT",
              "enum": [
                "APARTMENT",
                "HOUSE",
                "LOFT",
                "BOAT",
                "CAMPER_RV",
                "CONDOMINIUM",
                "CHALET",
                "BED_Breakfast",
                "VILLA",
                "TENT",
                "OTHER",
                "CABIN",
                "TOWNHOUSE",
                "BUNGALOW",
                "HUT",
                "DORM",
                "PARKING_SPACE",
                "PLANE",
                "TREEHOUSE",
                "YURT",
                "TIPI",
                "IGLOO",
                "EARTH_HOUSE",
                "ISLAND",
                "CAVE",
                "CASTLE",
                "STUDIO"
              ],
              "type": "string"
            }
          },
          {
            "description": "The listing type.",
            "required": false,
            "name": "listingType",
            "in": "query",
            "schema": {
              "example": "SINGLE",
              "enum": [
                "SINGLE",
                "MTL",
                "MTL_CHILD"
              ],
              "type": "string"
            }
          },
          {
            "description": "The listing room type.",
            "required": false,
            "name": "roomType",
            "in": "query",
            "schema": {
              "example": "PRIVATE_ROOM",
              "enum": [
                "PRIVATE_ROOM",
                "ENTIRE_HOME_APT",
                "SHARED_ROOM"
              ],
              "type": "string"
            }
          },
          {
            "description": "Minimum value of listing price. If it provided, the response will have listings which price is great or equal. Should be passed with currency query parameter",
            "required": false,
            "name": "minPrice",
            "in": "query",
            "schema": {
              "minimum": 0,
              "example": 10,
              "type": "number"
            }
          },
          {
            "description": "Maximum value of listing price. If it provided, the response will have listings which price is less or equal. Should be passed with currency query parameter",
            "required": false,
            "name": "maxPrice",
            "in": "query",
            "schema": {
              "minimum": 1,
              "example": 10,
              "type": "number"
            }
          },
          {
            "description": "Listing price currency. Should be provided with minPrice query parameter",
            "required": false,
            "name": "currency",
            "in": "query",
            "schema": {
              "example": "EUR",
              "enum": [
                "USD",
                "EUR",
                "AUD",
                "CAD",
                "JPY",
                "ILS",
                "GBP",
                "HKD",
                "NOK",
                "CZK",
                "BRL",
                "CHF",
                "THB",
                "ZAR",
                "MYR",
                "KRW",
                "IDR",
                "PHP",
                "INR",
                "NZD",
                "TWD",
                "PLN",
                "SGD",
                "TRY",
                "SEK",
                "VND",
                "ARS",
                "CNY",
                "DKK",
                "MXN"
              ],
              "type": "string"
            }
          },
          {
            "description": "Listing amenities separated by coma which should have listings. Possible values are listed in the enum.",
            "required": false,
            "name": "includeAmenities",
            "in": "query",
            "schema": {
              "example": "PETS_ALLOWED,SMOKING_ALLOWED,SUITABLE_FOR_INFANTS,SUITABLE_FOR_CHILDREN",
              "enum": [
                "ACCESSIBLE_HEIGHT_BED",
                "ACCESSIBLE_HEIGHT_TOILET",
                "AIR_CONDITIONING",
                "BABYSITTER_RECOMMENDATIONS",
                "BABY_BATH",
                "BABY_MONITOR",
                "BATHTUB",
                "BBQ_GRILL",
                "BEACH_ESSENTIALS",
                "BED_LINENS",
                "BREAKFAST",
                "CABLE_TV",
                "CARBON_MONOXIDE_DETECTOR",
                "CATS",
                "CHANGING_TABLE",
                "CHILDREN_BOOKS_AND_TOYS",
                "CHILDREN_DINNERWARE",
                "CLEANING_BEFORE_CHECKOUT",
                "COFFEE_MAKER",
                "COOKING_BASICS",
                "CRIB",
                "DISABLED_PARKING_SPOT",
                "DISHES_AND_SILVERWARE",
                "DISHWASHER",
                "DOGS",
                "DOORMAN",
                "DRYER",
                "ELEVATOR_IN_BUILDING",
                "ESSENTIALS",
                "ETHERNET_CONNECTION",
                "EV_CHARGER",
                "EXTRA_PILLOWS_AND_BLANKETS",
                "FIREPLACE_GUARDS",
                "FIRE_EXTINGUISHER",
                "FIRM_MATTRESS",
                "FIRST_AID_KIT",
                "FLAT_SMOOTH_PATHWAY_TO_FRONT_DOOR",
                "FREE_PARKING_ON_PREMISES",
                "GAME_CONSOLE",
                "GARDEN_OR_BACKYARD",
                "GRAB_RAILS_FOR_SHOWER_AND_TOILET",
                "GYM",
                "HAIR_DRYER",
                "HANGERS",
                "HEATING",
                "HIGH_CHAIR",
                "HOT_TUB",
                "HOT_WATER",
                "INDOOR_FIREPLACE",
                "INTERNET",
                "IRON",
                "KITCHEN",
                "LAPTOP_FRIENDLY_WORKSPACE",
                "LONG_TERM_STAYS_ALLOWED",
                "LUGGAGE_DROPOFF_ALLOWED",
                "MICROWAVE",
                "OTHER_PET",
                "OUTLET_COVERS",
                "OVEN",
                "PACK_N_PLAY_TRAVEL_CRIB",
                "PATH_TO_ENTRANCE_LIT_AT_NIGHT",
                "PATIO_OR_BALCONY",
                "PETS_ALLOWED",
                "PETS_LIVE_ON_THIS_PROPERTY",
                "POCKET_WIFI",
                "PRIVATE_ENTRANCE",
                "REFRIGERATOR",
                "ROLL_IN_SHOWER_WITH_SHOWER_BENCH_OR_CHAIR",
                "ROOM_DARKENING_SHADES",
                "SHAMPOO",
                "SINGLE_LEVEL_HOME",
                "SMOKE_DETECTOR",
                "SMOKING_ALLOWED",
                "STAIR_GATES",
                "STEP_FREE_ACCESS",
                "STOVE",
                "SUITABLE_FOR_CHILDREN",
                "SUITABLE_FOR_INFANTS",
                "TABLE_CORNER_GUARDS",
                "TUB_WITH_SHOWER_BENCH",
                "TV",
                "WASHER",
                "WIDE_CLEARANCE_TO_BED",
                "WIDE_CLEARANCE_TO_SHOWER_AND_TOILET",
                "WIDE_DOORWAY",
                "WIDE_HALLWAY_CLEARANCE",
                "WINDOW_GUARDS",
                "WIRELESS_INTERNET",
                "OUTDOOR_POOL",
                "COMMUNAL_POOL",
                "SWIMMING_POOL",
                "PRIVATE_POOL",
                "INDOOR_POOL"
              ],
              "type": "string"
            }
          },
          {
            "description": "Listing amenities separated by coma which should not have listings. Possible values are listed in the enum.",
            "required": false,
            "name": "excludeAmenities",
            "in": "query",
            "schema": {
              "example": "SMOKING_ALLOWED",
              "enum": [
                "ACCESSIBLE_HEIGHT_BED",
                "ACCESSIBLE_HEIGHT_TOILET",
                "AIR_CONDITIONING",
                "BABYSITTER_RECOMMENDATIONS",
                "BABY_BATH",
                "BABY_MONITOR",
                "BATHTUB",
                "BBQ_GRILL",
                "BEACH_ESSENTIALS",
                "BED_LINENS",
                "BREAKFAST",
                "CABLE_TV",
                "CARBON_MONOXIDE_DETECTOR",
                "CATS",
                "CHANGING_TABLE",
                "CHILDREN_BOOKS_AND_TOYS",
                "CHILDREN_DINNERWARE",
                "CLEANING_BEFORE_CHECKOUT",
                "COFFEE_MAKER",
                "COOKING_BASICS",
                "CRIB",
                "DISABLED_PARKING_SPOT",
                "DISHES_AND_SILVERWARE",
                "DISHWASHER",
                "DOGS",
                "DOORMAN",
                "DRYER",
                "ELEVATOR_IN_BUILDING",
                "ESSENTIALS",
                "ETHERNET_CONNECTION",
                "EV_CHARGER",
                "EXTRA_PILLOWS_AND_BLANKETS",
                "FIREPLACE_GUARDS",
                "FIRE_EXTINGUISHER",
                "FIRM_MATTRESS",
                "FIRST_AID_KIT",
                "FLAT_SMOOTH_PATHWAY_TO_FRONT_DOOR",
                "FREE_PARKING_ON_PREMISES",
                "GAME_CONSOLE",
                "GARDEN_OR_BACKYARD",
                "GRAB_RAILS_FOR_SHOWER_AND_TOILET",
                "GYM",
                "HAIR_DRYER",
                "HANGERS",
                "HEATING",
                "HIGH_CHAIR",
                "HOT_TUB",
                "HOT_WATER",
                "INDOOR_FIREPLACE",
                "INTERNET",
                "IRON",
                "KITCHEN",
                "LAPTOP_FRIENDLY_WORKSPACE",
                "LONG_TERM_STAYS_ALLOWED",
                "LUGGAGE_DROPOFF_ALLOWED",
                "MICROWAVE",
                "OTHER_PET",
                "OUTLET_COVERS",
                "OVEN",
                "PACK_N_PLAY_TRAVEL_CRIB",
                "PATH_TO_ENTRANCE_LIT_AT_NIGHT",
                "PATIO_OR_BALCONY",
                "PETS_ALLOWED",
                "PETS_LIVE_ON_THIS_PROPERTY",
                "POCKET_WIFI",
                "PRIVATE_ENTRANCE",
                "REFRIGERATOR",
                "ROLL_IN_SHOWER_WITH_SHOWER_BENCH_OR_CHAIR",
                "ROOM_DARKENING_SHADES",
                "SHAMPOO",
                "SINGLE_LEVEL_HOME",
                "SMOKE_DETECTOR",
                "SMOKING_ALLOWED",
                "STAIR_GATES",
                "STEP_FREE_ACCESS",
                "STOVE",
                "SUITABLE_FOR_CHILDREN",
                "SUITABLE_FOR_INFANTS",
                "TABLE_CORNER_GUARDS",
                "TUB_WITH_SHOWER_BENCH",
                "TV",
                "WASHER",
                "WIDE_CLEARANCE_TO_BED",
                "WIDE_CLEARANCE_TO_SHOWER_AND_TOILET",
                "WIDE_DOORWAY",
                "WIDE_HALLWAY_CLEARANCE",
                "WINDOW_GUARDS",
                "WIRELESS_INTERNET",
                "OUTDOOR_POOL",
                "COMMUNAL_POOL",
                "SWIMMING_POOL",
                "PRIVATE_POOL",
                "INDOOR_POOL"
              ],
              "type": "string"
            }
          },
          {
            "description": "Minimum longitude",
            "required": false,
            "name": "minLng",
            "in": "query",
            "schema": {
              "minimum": -180,
              "maximum": 180,
              "example": 24.052472,
              "type": "number"
            }
          },
          {
            "description": "Maximum longitude",
            "required": false,
            "name": "maxLng",
            "in": "query",
            "schema": {
              "minimum": -180,
              "maximum": 180,
              "example": 24.05687,
              "type": "number"
            }
          },
          {
            "description": "Minimum latitude",
            "required": false,
            "name": "minLat",
            "in": "query",
            "schema": {
              "minimum": -90,
              "maximum": 90,
              "example": 49.830034,
              "type": "number"
            }
          },
          {
            "description": "Maximum latitude",
            "required": false,
            "name": "maxLat",
            "in": "query",
            "schema": {
              "minimum": -90,
              "maximum": 90,
              "example": 49.8366506,
              "type": "number"
            }
          },
          {
            "description": "City name from the listings address",
            "required": false,
            "name": "city",
            "in": "query",
            "schema": {
              "example": "Houston",
              "type": "string"
            }
          },
          {
            "description": "Country name from the listings address",
            "required": false,
            "name": "country",
            "in": "query",
            "schema": {
              "example": "United States",
              "type": "string"
            }
          },
          {
            "description": "State name from the listings address",
            "required": false,
            "name": "state",
            "in": "query",
            "schema": {
              "example": "Texas",
              "type": "string"
            }
          },
          {
            "description": "neighborhood from the listings address",
            "required": false,
            "name": "neighborhood",
            "in": "query",
            "schema": {
              "example": "Harrisburg",
              "type": "string"
            }
          },
          {
            "description": "The list of the listing fields to return separated by spaces. The fields should be taken from Listing object definition. To include bed arrangements to a response, please add bedArrangements to the fields in query params.",
            "required": false,
            "name": "fields",
            "in": "query",
            "schema": {
              "example": "_id address.city title accommodates reviews",
              "type": "string"
            }
          },
          {
            "description": "checkin day in format YYYY-MM-DD",
            "required": false,
            "name": "checkIn",
            "in": "query",
            "schema": {
              "example": "2021-12-20",
              "type": "string"
            }
          },
          {
            "description": "checkout day in format YYYY-MM-DD",
            "required": false,
            "name": "checkOut",
            "in": "query",
            "schema": {
              "example": "2021-12-25",
              "type": "string"
            }
          },
          {
            "description": "Limit the number of results within a subset. Default value is 20, max value is 100",
            "required": false,
            "name": "limit",
            "in": "query",
            "schema": {
              "minimum": 1,
              "maximum": 100,
              "default": 20,
              "example": 15,
              "type": "integer"
            }
          },
          {
            "description": "Limit results to listings with specific tag, can be used multiple times for and function",
            "required": false,
            "name": "tags",
            "in": "query",
            "schema": {
              "example": "tags=kinesu&tags=ExtendedStay",
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "description": "one of bed types",
            "required": false,
            "name": "kingBed",
            "in": "query",
            "schema": {
              "minimum": 1,
              "example": 2,
              "type": "integer"
            }
          },
          {
            "description": "one of bed types",
            "required": false,
            "name": "queenBed",
            "in": "query",
            "schema": {
              "minimum": 1,
              "example": 2,
              "type": "integer"
            }
          },
          {
            "description": "one of bed types",
            "required": false,
            "name": "doubleBed",
            "in": "query",
            "schema": {
              "minimum": 1,
              "example": 2,
              "type": "integer"
            }
          },
          {
            "description": "one of bed types",
            "required": false,
            "name": "singleBed",
            "in": "query",
            "schema": {
              "minimum": 1,
              "example": 2,
              "type": "integer"
            }
          },
          {
            "description": "one of bed types",
            "required": false,
            "name": "sofaBed",
            "in": "query",
            "schema": {
              "minimum": 1,
              "example": 2,
              "type": "integer"
            }
          },
          {
            "description": "one of bed types",
            "required": false,
            "name": "airMattress",
            "in": "query",
            "schema": {
              "minimum": 1,
              "example": 2,
              "type": "integer"
            }
          },
          {
            "description": "one of bed types",
            "required": false,
            "name": "bunkBed",
            "in": "query",
            "schema": {
              "minimum": 1,
              "example": 2,
              "type": "integer"
            }
          },
          {
            "description": "one of bed types",
            "required": false,
            "name": "floorMattress",
            "in": "query",
            "schema": {
              "minimum": 1,
              "example": 2,
              "type": "integer"
            }
          },
          {
            "description": "one of bed types",
            "required": false,
            "name": "waterBed",
            "in": "query",
            "schema": {
              "minimum": 1,
              "example": 2,
              "type": "integer"
            }
          },
          {
            "description": "one of bed types",
            "required": false,
            "name": "toddlerBed",
            "in": "query",
            "schema": {
              "minimum": 1,
              "example": 2,
              "type": "integer"
            }
          },
          {
            "description": "one of bed types",
            "required": false,
            "name": "crib",
            "in": "query",
            "schema": {
              "minimum": 1,
              "example": 2,
              "type": "integer"
            }
          },
          {
            "description": "Limit results to listings' unit type house rules",
            "required": false,
            "name": "petsAllowed",
            "in": "query",
            "schema": {
              "example": true,
              "type": "boolean"
            }
          },
          {
            "description": "Limit results to listings' unit type house rules",
            "required": false,
            "name": "smokingAllowed",
            "in": "query",
            "schema": {
              "example": true,
              "type": "boolean"
            }
          },
          {
            "description": "Limit results to listings' unit type house rules",
            "required": false,
            "name": "suitableForEvents",
            "in": "query",
            "schema": {
              "example": true,
              "type": "boolean"
            }
          },
          {
            "description": "Limit results to listings' unit type house rules",
            "required": false,
            "name": "suitableForChildren",
            "in": "query",
            "schema": {
              "example": true,
              "type": "boolean"
            }
          },
          {
            "description": "Limit results to listings' unit type house rules",
            "required": false,
            "name": "suitableForInfants",
            "in": "query",
            "schema": {
              "example": true,
              "type": "boolean"
            }
          },
          {
            "description": "Provide cursor received from the response to iterate over pages",
            "required": false,
            "name": "cursor",
            "in": "query",
            "schema": {
              "example": "eyJuZXh0Q3Vyc29yIjp7Imxpc3RpbmdJZCI6IjYwOWQ2YWI0MjU5ZWQxMDAyZDFlYWRjYiJ9fQ==",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "successful operation",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "results": {
                      "description": "List of application listings filtered by given parameters",
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "_id": {
                            "type": "string"
                          },
                          "type": {
                            "type": "string",
                            "enum": [
                              "SINGLE",
                              "MTL",
                              "MTL_CHILD"
                            ]
                          },
                          "propertyType": {
                            "type": "string",
                            "enum": [
                              "Apartment",
                              "House",
                              "Loft",
                              "Boat",
                              "Camper/RV",
                              "Condominium",
                              "Chalet",
                              "Bed & Breakfast",
                              "Villa",
                              "Tent",
                              "Other",
                              "Cabin",
                              "Townhouse",
                              "Bungalow",
                              "Hut",
                              "Dorm",
                              "Parking Space",
                              "Plane",
                              "Treehouse",
                              "Yurt",
                              "Tipi",
                              "Igloo",
                              "Earth House",
                              "Island",
                              "Cave",
                              "Castle",
                              "Studio"
                            ]
                          },
                          "roomType": {
                            "type": "string",
                            "enum": [
                              "Private room",
                              "Entire home/apt",
                              "Shared room"
                            ]
                          },
                          "title": {
                            "type": "string"
                          },
                          "accommodates": {
                            "type": "integer"
                          },
                          "address": {
                            "type": "object",
                            "properties": {
                              "city": {
                                "type": "string"
                              },
                              "country": {
                                "type": "string"
                              },
                              "full": {
                                "type": "string"
                              },
                              "lat": {
                                "type": "number"
                              },
                              "lng": {
                                "type": "number"
                              },
                              "state": {
                                "type": "string"
                              },
                              "street": {
                                "type": "string"
                              },
                              "neighborhood": {
                                "type": "string"
                              }
                            }
                          },
                          "timezone": {
                            "type": "string"
                          },
                          "amenities": {
                            "type": "array",
                            "items": {
                              "type": "string",
                              "enum": [
                                "Accessible-height bed",
                                "Accessible-height toilet",
                                "Air conditioning",
                                "Babysitter recommendations",
                                "Baby bath",
                                "Baby monitor",
                                "Bathtub",
                                "BBQ grill",
                                "Beach essentials",
                                "Bed linens",
                                "Breakfast",
                                "Cable TV",
                                "Carbon monoxide detector",
                                "Cat(s)",
                                "Changing table",
                                "Children's books and toys",
                                "Children's dinnerware",
                                "Cleaning before checkout",
                                "Coffee maker",
                                "Communal pool",
                                "Cooking basics",
                                "Crib",
                                "Disabled parking spot",
                                "Dishes and silverware",
                                "Dishwasher",
                                "Dog(s)",
                                "Doorman",
                                "Dryer",
                                "Elevator in building",
                                "Essentials",
                                "Ethernet connection",
                                "EV charger",
                                "Extra pillows and blankets",
                                "Fireplace guards",
                                "Fire extinguisher",
                                "Firm mattress",
                                "First aid kit",
                                "Flat smooth pathway to front door",
                                "Free parking on premises",
                                "Game console",
                                "Garden or backyard",
                                "Grab-rails for shower and toilet",
                                "Gym",
                                "Hair dryer",
                                "Hangers",
                                "Heating",
                                "High chair",
                                "Hot tub",
                                "Hot water",
                                "Indoor fireplace",
                                "Indoor pool",
                                "Internet",
                                "Iron",
                                "Kitchen",
                                "Laptop friendly workspace",
                                "Long term stays allowed",
                                "Luggage dropoff allowed",
                                "Microwave",
                                "Other pet(s)",
                                "Outlet covers",
                                "Oven",
                                "Pack 'n Play/travel crib",
                                "Path to entrance lit at night",
                                "Patio or balcony",
                                "Pets allowed",
                                "Pets live on this property",
                                "Pocket wifi",
                                "Private entrance",
                                "Private pool",
                                "Refrigerator",
                                "Roll-in shower with shower bench or chair",
                                "Room-darkening shades",
                                "Shampoo",
                                "Single level home",
                                "Smoke detector",
                                "Smoking allowed",
                                "Stair gates",
                                "Step-free access",
                                "Stove",
                                "Suitable for children (2-12 years)",
                                "Suitable for infants (under 2 years)",
                                "Swimming pool",
                                "Table corner guards",
                                "Tub with shower bench",
                                "TV",
                                "Washer",
                                "Wide clearance to bed",
                                "Wide clearance to shower and toilet",
                                "Wide doorway",
                                "Wide hallway clearance",
                                "Window guards",
                                "Wireless Internet",
                                "Outdoor pool"
                              ]
                            }
                          },
                          "bathrooms": {
                            "type": "integer"
                          },
                          "bedrooms": {
                            "type": "integer"
                          },
                          "beds": {
                            "type": "integer"
                          },
                          "picture": {
                            "type": "object",
                            "properties": {
                              "original": {
                                "type": "string"
                              },
                              "thumbnail": {
                                "type": "string"
                              },
                              "regular": {
                                "type": "string"
                              },
                              "large": {
                                "type": "string"
                              },
                              "caption": {
                                "type": "string"
                              }
                            }
                          },
                          "pictures": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "original": {
                                  "type": "string"
                                },
                                "large": {
                                  "type": "string"
                                },
                                "regular": {
                                  "type": "string"
                                },
                                "thumbnail": {
                                  "type": "string"
                                },
                                "caption": {
                                  "type": "string"
                                }
                              }
                            }
                          },
                          "prices": {
                            "type": "object",
                            "properties": {
                              "basePrice": {
                                "type": "number",
                                "example": 1
                              },
                              "currency": {
                                "type": "string",
                                "enum": [
                                  "USD",
                                  "EUR",
                                  "AUD",
                                  "CAD",
                                  "JPY",
                                  "ILS",
                                  "GBP",
                                  "HKD",
                                  "NOK",
                                  "CZK",
                                  "BRL",
                                  "CHF",
                                  "THB",
                                  "ZAR",
                                  "MYR",
                                  "KRW",
                                  "IDR",
                                  "PHP",
                                  "INR",
                                  "NZD",
                                  "TWD",
                                  "PLN",
                                  "SGD",
                                  "TRY",
                                  "SEK",
                                  "VND",
                                  "ARS",
                                  "CNY",
                                  "DKK",
                                  "MXN"
                                ]
                              },
                              "monthlyPriceFactor": {
                                "type": "number"
                              },
                              "weeklyPriceFactor": {
                                "type": "number"
                              },
                              "extraPersonFee": {
                                "type": "number"
                              },
                              "cleaningFee": {
                                "type": "number"
                              },
                              "petFee": {
                                "type": "number"
                              }
                            }
                          },
                          "publicDescription": {
                            "type": "object",
                            "properties": {
                              "summary": {
                                "type": "string"
                              },
                              "space": {
                                "type": "string"
                              },
                              "access": {
                                "type": "string"
                              },
                              "notes": {
                                "type": "string"
                              },
                              "transit": {
                                "type": "string"
                              },
                              "interactionWithGuests": {
                                "type": "string"
                              },
                              "neighborhood": {
                                "type": "string"
                              },
                              "guestControls": {
                                "type": "object",
                                "properties": {
                                  "allowsChildren": {
                                    "type": "boolean"
                                  },
                                  "allowsInfants": {
                                    "type": "boolean"
                                  },
                                  "allowsPets": {
                                    "type": "boolean"
                                  },
                                  "allowsSmoking": {
                                    "type": "boolean"
                                  },
                                  "allowsEvents": {
                                    "type": "boolean"
                                  }
                                }
                              },
                              "houseRules": {
                                "type": "string"
                              }
                            }
                          },
                          "allotment": {
                            "type": "object",
                            "description": "Depends on checkIn and checkOut",
                            "example": {
                              "2021-12-30": 2,
                              "2021-12-31": 2
                            }
                          },
                          "nightlyRates": {
                            "type": "object",
                            "description": "Depends on checkIn and checkOut",
                            "example": {
                              "2022-03-25": 100,
                              "2022-03-26": 200
                            }
                          },
                          "reviews": {
                            "type": "object",
                            "properties": {
                              "avg": {
                                "type": "number"
                              },
                              "total": {
                                "type": "number"
                              }
                            }
                          },
                          "tags": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "bedArrangements": {
                            "type": "object",
                            "properties": {
                              "unitTypeId": {
                                "type": "string",
                                "pattern": "^[0-9a-fA-F]{24}$",
                                "description": "unit type id"
                              },
                              "accountId": {
                                "type": "string",
                                "pattern": "^[0-9a-fA-F]{24}$",
                                "description": "account id"
                              },
                              "bedrooms": {
                                "description": "bedroom description",
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "roomNumber": {
                                      "type": "number",
                                      "description": "value of room numbers",
                                      "example": 1
                                    },
                                    "name": {
                                      "type": "string",
                                      "description": "room name"
                                    },
                                    "type": {
                                      "type": "string",
                                      "description": "room type",
                                      "enum": [
                                        "BEDROOM",
                                        "SHARED_SPACE"
                                      ]
                                    },
                                    "beds": {
                                      "type": "object",
                                      "properties": {
                                        "KING_BED": {
                                          "type": "number",
                                          "example": 1,
                                          "default": 0
                                        },
                                        "QUEEN_BED": {
                                          "type": "number",
                                          "example": 1,
                                          "default": 0
                                        },
                                        "DOUBLE_BED": {
                                          "type": "number",
                                          "example": 1,
                                          "default": 0
                                        },
                                        "SINGLE_BED": {
                                          "type": "number",
                                          "example": 1,
                                          "default": 0
                                        },
                                        "SOFA_BED": {
                                          "type": "number",
                                          "example": 1,
                                          "default": 0
                                        },
                                        "AIR_MATTRESS": {
                                          "type": "number",
                                          "example": 1,
                                          "default": 0
                                        },
                                        "BUNK_BED": {
                                          "type": "number",
                                          "example": 1,
                                          "default": 0
                                        },
                                        "FLOOR_MATTRESS": {
                                          "type": "number",
                                          "example": 1,
                                          "default": 0
                                        },
                                        "WATER_BED": {
                                          "type": "number",
                                          "example": 1,
                                          "default": 0
                                        },
                                        "TODDLER_BED": {
                                          "type": "number",
                                          "example": 1,
                                          "default": 0
                                        },
                                        "CRIB": {
                                          "type": "number",
                                          "example": 1,
                                          "default": 0
                                        }
                                      }
                                    }
                                  }
                                }
                              },
                              "bedroomsAllowed": {
                                "type": "boolean"
                              },
                              "isDefaultBedArrangement": {
                                "type": "boolean"
                              },
                              "bathrooms": {
                                "type": "object",
                                "properties": {
                                  "BEDROOM": {
                                    "type": "number",
                                    "description": "value of bedroom numbers",
                                    "example": 1
                                  },
                                  "PRIVATE": {
                                    "type": "number",
                                    "description": "value of private numbers",
                                    "example": 1
                                  }
                                }
                              },
                              "deleted": {
                                "type": "boolean",
                                "default": false
                              },
                              "deletedAt": {
                                "type": "string",
                                "format": "date-time"
                              }
                            },
                            "required": [
                              "unitTypeId",
                              "accountId",
                              "deleted"
                            ]
                          },
                          "unitTypeHouseRules": {
                            "type": "object",
                            "properties": {
                              "unitTypeId": {
                                "type": "string",
                                "pattern": "^[0-9a-fA-F]{24}$",
                                "description": "unit type id"
                              },
                              "houseRules": {
                                "type": "object",
                                "properties": {
                                  "additionalRules": {
                                    "type": "string"
                                  },
                                  "petsAllowed": {
                                    "type": "object",
                                    "properties": {
                                      "enabled": {
                                        "type": "boolean"
                                      },
                                      "chargeType": {
                                        "type": "string"
                                      }
                                    }
                                  },
                                  "quietBetween": {
                                    "type": "object",
                                    "properties": {
                                      "enabled": {
                                        "type": "boolean"
                                      },
                                      "hours": {
                                        "type": "object",
                                        "properties": {
                                          "start": {
                                            "type": "string",
                                            "format": "date-time"
                                          },
                                          "end": {
                                            "type": "string",
                                            "format": "date-time"
                                          }
                                        }
                                      }
                                    }
                                  },
                                  "smokingAllowed": {
                                    "type": "object",
                                    "properties": {
                                      "enabled": {
                                        "type": "boolean"
                                      }
                                    }
                                  },
                                  "suitableForEvents": {
                                    "type": "object",
                                    "properties": {
                                      "enabled": {
                                        "type": "boolean"
                                      }
                                    }
                                  },
                                  "childrenRules": {
                                    "type": "object",
                                    "properties": {
                                      "suitableForChildren": {
                                        "type": "boolean"
                                      },
                                      "suitableForInfants": {
                                        "type": "boolean"
                                      },
                                      "reason": {
                                        "type": "string"
                                      }
                                    }
                                  }
                                }
                              },
                              "deleted": {
                                "type": "boolean",
                                "default": false
                              },
                              "deletedAt": {
                                "type": "string",
                                "format": "date-time"
                              }
                            },
                            "required": [
                              "unitTypeId",
                              "houseRules",
                              "deleted"
                            ]
                          }
                        }
                      }
                    },
                    "pagination": {
                      "type": "object",
                      "properties": {
                        "total": {
                          "type": "integer"
                        },
                        "cursor": {
                          "type": "object",
                          "properties": {
                            "next": {
                              "type": "string",
                              "nullable": true
                            }
                          }
                        }
                      }
                    }
                  },
                  "required": [
                    "results"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "data": {
                          "type": "object",
                          "properties": {
                            "requestId": {
                              "type": "string"
                            },
                            "moreDetails": {
                              "type": "object"
                            }
                          },
                          "required": [
                            "requestId"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "data"
                      ]
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Not authorized",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "data": {
                          "type": "object",
                          "properties": {
                            "requestId": {
                              "type": "string"
                            },
                            "moreDetails": {
                              "type": "object"
                            }
                          },
                          "required": [
                            "requestId"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "data"
                      ]
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Too many requests",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "data": {
                          "type": "object",
                          "properties": {
                            "requestId": {
                              "type": "string"
                            },
                            "moreDetails": {
                              "type": "object"
                            }
                          },
                          "required": [
                            "requestId"
                          ]
                        }
                      },
                      "required": [
                        "code",
                        "message",
                        "data"
                      ]
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Listings"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ]
      }
    }
  },
  "info": {
    "title": "Booking Engine API",
    "description": "Booking Engine API",
    "version": "1.0",
    "contact": {}
  },
  "servers": [
    {
      "url": "https://booking.guesty.com/"
    }
  ],
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "type": "apiKey",
        "in": "header",
        "name": "authorization"
      }
    }
  },
  "security": [
    {
      "bearerAuth": []
    }
  ]
}
```