---
title: "Fetch a listing."
method: GET
path: "/v2/listings/{id}"
tags: ["Listings"]
---

# Fetch a listing.

`GET /v2/listings/{id}`

## Path parameters

- `id` integer, required

## Query parameters

- `descriptionFormat` 'html' | 'text'

## Response `200`

- ListingViewModel
  - `amenity_call_outs` AmenityCallOutModel[]
    - `icon` string
    - `text` string
    - `title` string
  - `amenity_categories` AmenityCategoryModel[]
    - `amenities` AmenityCallOutModel[]
      - `icon` string
      - `text` string
      - `title` string
    - `caption` string
    - `type` string
  - `bathroom_count` integer — The number of bathrooms in this listing.
  - `bathroom_full_count` integer — The number of "full" bathrooms in this listing.
  - `bathroom_half_count` integer — The number of "half" bathrooms in this listing.
  - `bathrooms` BathroomModel[]
    - `description` string
    - `name` string
    - `type` 'full' | 'half' | 'shower_only' | 'ensuite'
  - `bedroom_count` integer — The number of bedrooms in this listing.
  - `cancellation_policy` string
  - `check_in_instructions` string — Check-in instructions for the listing. Can contain HTML.
  - `descriptions` DescriptionsModel — A set of property listing descriptions, formatted as either HTML or Text.
    - `accommodations_detail` string
    - `accommodations_summary` string
    - `description` string
    - `features_description` string
    - `getting_around` string
    - `getting_there` string
    - `guest_access` string
    - `headline` string
    - `location_description` string
    - `location_other_activities` string
    - `owner_listing_story` string
    - `rate_notes` string
    - `short_description` string
    - `unique_benefits` string
    - `why_purchased` string
    - `year_purchased` string
  - `directions` string — Directions to the listing. Can contain HTML.
  - `house_manual` string — House manual for the listing. Can contain HTML.
  - `internet_info` string — Internet/Wifi details for the listing. Can contain HTML.
  - `location_types` LocationTypeFeatures[]
  - `nightly_rate_max` number, nullable
  - `nightly_rate_min` number, nullable
  - `occupancy_max` integer, nullable — The maximum occupancy of this listing.
  - `occupancy_min` integer — The minimum occupancy of this listing.
  - `photos` ImageFileModel[]
    - `caption` string — The caption of this image.
    - `cropped_url` string — The URL of the small cropped/resized version of this image.
    - `large_url` string — The URL of the large cropped/resized version of this image.
    - `original_url` string — The URL of the original image.
    - `video_url` string — The URL of a video related to this image.
  - `property_id` integer — The ID of the property to which this listing content pertains.
  - `property_space_type` 'entire_home' | 'private_room' | 'shared_room'
  - `registration_date` string, date-time, nullable
  - `registration_number` string
  - `review_average` number
  - `review_count` integer
  - `rooms` RoomModel[]
    - `description` string
    - `name` string
    - `total_beds` integer
    - `type` 'bedroom' | 'studio' | 'common_spaces' | 'backyard' | 'basement' | 'dining_room' | 'entrance_to_home' | 'entry' | 'exterior' | 'front_yard' | 'family_room' | 'hot_tub' | 'garage' | 'gym' | 'kitchen' | 'kitchenette' | 'laundry_room' | 'living_room' | 'office' | 'outdoor_common_area' | 'outdoor_space' | 'patio' | 'pool' | 'recreation_area' | 'study' | 'art_studio' | 'balcony' | 'bar' | 'beach' | 'bowling_alley' | 'casino' | 'childrens_playroom' | 'conservatory' | 'courtyard' | 'darkroom' | 'event_room' | 'game_room' | 'library' | 'lobby' | 'movie_theater' | 'music_studio' | 'neighborhood' | 'other' | 'photography_studio' | 'porch' | 'restaurant' | 'rooftop' | 'spa' | 'sunroom' | 'terrace' | 'theme_room' | 'wine_cellar' | 'woodshop' | 'workshop' | 'workspace' | 'writers_retreat'
  - `sleeps_in_beds_count` integer, nullable — The calculated maximum number of occupants this listing can fit into beds.
  - `sleeps_max` integer, nullable
  - `sleeps_min` integer, nullable
  - `wifi_network` string — Wifi network name for internet access at the property.
  - `wifi_password` string — Wifi network password for internet access at the property.

---

[API](https://skmtc.net/ownerrez/apis/ownerrez-api.md) · [All operations](https://skmtc.net/ownerrez/apis/ownerrez-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ownerrez/ownerrez-api/versions/fa0c0f146039/schema)