---
title: "Get a specific listing"
method: GET
path: "/api/listings/{listingId}"
tags: ["Listings"]
---

# Get a specific listing

`GET /api/listings/{listingId}`

This call returns a listing by ID

## Path parameters

- `listingId` string, required

## Query parameters

- `fields` string

## Response `200`

successful operation

- object
  - `results` object, required
    - `_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
    - `nickname` 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
    - `bedType` string
    - `defaultCheckInTime` string
    - `defaultCheckOutTime` 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
    - `terms` object
      - `minNights` integer
      - `maxNights` integer
      - `cancellation` string
    - `taxes` object[]
      - `_id` string
      - `amount` number
      - `appliedToAllFees` boolean
      - `appliedOnFees` string[]
      - `name` string
      - `quantifier` 'PER_NIGHT' | 'PER_GUEST' | 'PER_GUEST_PER_NIGHT' | 'PER_STAY'
      - `type` 'LOCAL_TAX' | 'CITY_TAX' | 'VAT' | 'GOODS_AND_SERVICES_TAX' | 'TOURISM_TAX' | 'OTHER'
      - `units` 'PERCENTAGE' | 'FIXED'
    - `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
    - `autoPayments` object
      - `policy` object[]
        - `scheduleTo` object
          - `reservationEvent` 'CHECK_IN' | 'CHECK_OUT' | 'CONFIRMATION'
          - `timeRelation` object
            - `relation` 'AT' | 'BEFORE' | 'AFTER'
            - `unit` 'SECONDS' | 'MINUTES' | 'HOURS' | 'DAYS'
            - `amount` number
        - `chargeAuthorizationHold` object
          - `inUse` boolean
          - `scheduleTo` object
            - `reservationEvent` 'CHECK_IN' | 'CHECK_OUT' | 'CONFIRMATION'
            - `timeRelation` object
              - …
          - `chargeType` 'REST_OF_PAYMENT' | 'PERCENTAGE' | 'FIXED'
          - `amount` number
        - `releaseAuthorizationHold` object
          - `inUse` boolean
          - `scheduleTo` object
            - `reservationEvent` 'CHECK_IN' | 'CHECK_OUT' | 'CONFIRMATION'
            - `timeRelation` object
              - …
          - `chargeType` 'REST_OF_PAYMENT' | 'PERCENTAGE' | 'FIXED'
        - `chargeType` 'REST_OF_PAYMENT' | 'PERCENTAGE' | 'FIXED'
        - `amount` number
        - `useGuestCard` boolean
        - `isAuthorizationHold` boolean
        - `notifyIfHoldFails` boolean
        - `whenContext` 'preConfirmation' | 'checkIn' | 'checkOut' | 'confirmedAt'

## Other responses

- `400` — Bad request
- `401` — Not authorized
- `403` — Forbidden
- `404` — Listing not found
- `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)