---
title: "Get all the listings included in the booking engine"
method: GET
path: "/api/listings"
tags: ["Listings"]
---

# Get all the listings included in the booking engine

`GET /api/listings`

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

## Query parameters

- `minOccupancy` integer
- `numberOfBedrooms` integer
- `numberOfBathrooms` integer
- `propertyType` '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'
- `listingType` 'SINGLE' | 'MTL' | 'MTL_CHILD'
- `roomType` 'PRIVATE_ROOM' | 'ENTIRE_HOME_APT' | 'SHARED_ROOM'
- `minPrice` number
- `maxPrice` number
- `currency` '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'
- `includeAmenities` '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'
- `excludeAmenities` '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'
- `minLng` number
- `maxLng` number
- `minLat` number
- `maxLat` number
- `city` string
- `country` string
- `state` string
- `neighborhood` string
- `fields` string
- `checkIn` string
- `checkOut` string
- `limit` integer
- `tags` string[]
- `kingBed` integer
- `queenBed` integer
- `doubleBed` integer
- `singleBed` integer
- `sofaBed` integer
- `airMattress` integer
- `bunkBed` integer
- `floorMattress` integer
- `waterBed` integer
- `toddlerBed` integer
- `crib` integer
- `petsAllowed` boolean
- `smokingAllowed` boolean
- `suitableForEvents` boolean
- `suitableForChildren` boolean
- `suitableForInfants` boolean
- `cursor` string

## Response `200`

successful operation

- object
  - `results` object[], required — List of application listings filtered by given parameters
    - `_id` string
    - `type` 'SINGLE' | 'MTL' | 'MTL_CHILD'
    - `propertyType` '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` 'Private room' | 'Entire home/apt' | 'Shared room'
    - `title` string
    - `accommodates` integer
    - `address` object
      - `city` string
      - `country` string
      - `full` string
      - `lat` number
      - `lng` number
      - `state` string
      - `street` string
      - `neighborhood` string
    - `timezone` string
    - `amenities` string[]
    - `bathrooms` integer
    - `bedrooms` integer
    - `beds` integer
    - `picture` object
      - `original` string
      - `thumbnail` string
      - `regular` string
      - `large` string
      - `caption` string
    - `pictures` object[]
      - `original` string
      - `large` string
      - `regular` string
      - `thumbnail` string
      - `caption` string
    - `prices` object
      - `basePrice` number
      - `currency` '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` number
      - `weeklyPriceFactor` number
      - `extraPersonFee` number
      - `cleaningFee` number
      - `petFee` number
    - `publicDescription` object
      - `summary` string
      - `space` string
      - `access` string
      - `notes` string
      - `transit` string
      - `interactionWithGuests` string
      - `neighborhood` string
      - `guestControls` object
        - `allowsChildren` boolean
        - `allowsInfants` boolean
        - `allowsPets` boolean
        - `allowsSmoking` boolean
        - `allowsEvents` boolean
      - `houseRules` string
    - `allotment` object — Depends on checkIn and checkOut
    - `nightlyRates` object — Depends on checkIn and checkOut
    - `reviews` object
      - `avg` number
      - `total` number
    - `tags` string[]
    - `bedArrangements` object
      - `unitTypeId` string, required — unit type id
      - `accountId` string, required — account id
      - `bedrooms` object[] — bedroom description
        - `roomNumber` number — value of room numbers
        - `name` string — room name
        - `type` 'BEDROOM' | 'SHARED_SPACE' — room type
        - `beds` object
          - `KING_BED` number
          - `QUEEN_BED` number
          - `DOUBLE_BED` number
          - `SINGLE_BED` number
          - `SOFA_BED` number
          - `AIR_MATTRESS` number
          - `BUNK_BED` number
          - `FLOOR_MATTRESS` number
          - `WATER_BED` number
          - `TODDLER_BED` number
          - `CRIB` number
      - `bedroomsAllowed` boolean
      - `isDefaultBedArrangement` boolean
      - `bathrooms` object
        - `BEDROOM` number — value of bedroom numbers
        - `PRIVATE` number — value of private numbers
      - `deleted` boolean, required
      - `deletedAt` string, date-time
    - `unitTypeHouseRules` object
      - `unitTypeId` string, required — unit type id
      - `houseRules` object, required
        - `additionalRules` string
        - `petsAllowed` object
          - `enabled` boolean
          - `chargeType` string
        - `quietBetween` object
          - `enabled` boolean
          - `hours` object
            - `start` string, date-time
            - `end` string, date-time
        - `smokingAllowed` object
          - `enabled` boolean
        - `suitableForEvents` object
          - `enabled` boolean
        - `childrenRules` object
          - `suitableForChildren` boolean
          - `suitableForInfants` boolean
          - `reason` string
      - `deleted` boolean, required
      - `deletedAt` string, date-time
  - `pagination` object
    - `total` integer
    - `cursor` object
      - `next` string, nullable

## Other responses

- `400` — Bad request
- `401` — Not authorized
- `429` — Too many requests

---

[API](https://skmtc.dev/guesty/apis/booking-engine-api.md) · [All operations](https://skmtc.dev/guesty/apis/booking-engine-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/guesty/booking-engine-api/revisions/90f25f70255b/schema)