--- title: "Fetch details about a specific Listing." method: GET path: "/listing/{listingId}" tags: ["listing_data"] --- # Fetch details about a specific Listing. `GET /listing/{listingId}` This endpoint returns details about a specific listing. This request will return details such as: * **Number of bedrooms and bathrooms** * **Overall Rating** * **Review Count** * **Metrics such as ADR, Revenue, and Occupancy** * **Amenities** ## Path parameters - `listingId` string, required — AirDNA ID for the Listing. This can often be found as `property_id`. The ID is prefixed with the channel the Listing belongs to: - `abnb_` for Airbnb - `vrbo_` for Vrbo - `bkng_` for Booking.com Smart Rates endpoints currently only model Airbnb Listings; requests with `vrbo_*` or `bkng_*` IDs are rejected with a `"Smart Rates does not yet model Booking.com / Vrbo listings."` envelope. ## Response `200` Successful Listing Details Response - object - `payload` Listing, required - `property_id` string, required — The AirDNA ID for the Listing. - `details` ListingDetails, required - `title` string, required — Title of the Listing. - `market_name` string, required — The name of the Market that the Listing belongs to. - `accommodates` integer, required — Number of guests the Listing accommodates. - `bedrooms` integer, required — Number of bedrooms the Listing has. - `bathrooms` number, required — Number of bathrooms the Listing has. - `reviews` integer, required — Number of reviews the Listing has. - `rating` number, nullable, required — Rating of the Listing on a scale of 0 to 5. - `images` string[], required — List of image URLs for the Listing. - `price_tier` 'budget' | 'economy' | 'midscale' | 'upscale' | 'luxury', required — The price category of the Listing. - `property_type` 'apartment' | 'barn' | 'bed_and_breakfast' | 'boat' | 'building' | 'bungalow' | 'bus' | 'cabin' | 'camper_rv' | 'campsite' | 'caravan' | 'casa_particular' | 'castle' | 'cave' | 'chalet' | 'condominium' | 'corporate_apartment' | 'cottage' | 'country_house' | 'cycladic_house' | 'dammuso' | 'dome_house' | 'earth_house' | 'estate' | 'farm_stay' | 'farmhouse' | 'guest_house' | 'guest_suite' | 'holiday_park' | 'house' | 'house_boat' | 'hut' | 'igloo' | 'island' | 'kezhan' | 'lighthouse' | 'loft' | 'mas' | 'mobile_home' | 'nature_lodge' | 'other' | 'place' | 'ranch' | 'riad' | 'serviced_apartment' | 'shepherds_hut' | 'shipping_container' | 'studio' | 'tent' | 'tiny_house' | 'tipi' | 'tower' | 'townhouse' | 'train' | 'treehouse' | 'vacation_home' | 'villa' | 'windmill' | 'yacht' | 'yurt', nullable, required — The property type of the Listing. - `listing_type` 'entire_place' | 'private_room' | 'shared_room', required — The room type of the Listing. - `real_estate_type` 'apartment' | 'bed_and_breakfast' | 'house' | 'unique', required — The real estate type of the Listing. - `instant_book` boolean, required — Whether the Listing supports Instant Book. - `superhost` boolean, required — Whether the Listing is a Superhost. - `cancellation_policy` 'flexible' | 'moderate' | 'strict' | 'super_strict' | 'no refund', nullable, required — The type of cancellation policy for the Listing. - `host_size` '1' | '2-5' | '6-20' | '21+', required — The numeric range of Listings that the Host manages. - `minimum_stay` integer, required — The minimum stay (in nights) required to reserve the Listing. - `created_date` string, date, required — The date that the Listing was created in `YYYY-MM-DD` format. - `license` string, nullable, required — The Airbnb or Vrbo license number. - `cleaning_fee` integer, nullable, required — The cost of the cleaning fee per reservation for the Listing in the requested currency. - `location` GeomPoint, required — ISO 6709 Coordinates. - `lat` number, required — ISO 6709 Latitude coordinate. - `lng` number, required — ISO 6709 Longitude coordinate. - `exact_location` boolean, nullable, required — A boolean value indicating if the location value is exact or not. - `true` indicates that the latitude and longitude are the exact coordinates of the Listing. - `false` indicates that the latitude and longitude are scrambled coordinates within a 500 meter radius of the Listing. - `location_area` ListingLocationArea, required — Information about the location where the Listing resides. - `country_name` string, required — The name of the Country that the Listing belongs to. - `city_name` string, required — The name of the City that the Listing belongs to. - `state_name` string, nullable, required — The name of the State that the Listing belongs to. - `zipcode` string, nullable, required — The zipcode that the Listing belongs to (US-only). - `msa_name` string, nullable, required — The metropolitan statistical area that the listing belongs to (US-only). - `metrics` ListingMetrics, required — Performance metrics for the Listing based on the **Last 12 months**. - `occupancy` number, required — Occupancy rate of the Listing in the last 12 months. - `adr` number, required — Average daily rate of the Listing in the last 12 months. - `revenue` integer, required — Total revenue generated by the Listing in the last 12 months. - `revenue_potential` integer, required — Potential revenue for the Listing in the last 12 months. - `days_available` integer, required — The number of days the Listing was available in the last 12 months. This includes days reserved/booked. - `days_blocked` integer, required — The number of days the Listing was blocked in the last 12 months. - `days_reserved` integer, required — The number of days the Listing was reserved/booked in the last 12 months. - `num_reservations` integer, required — The number of reservations/bookings made at the Listing in the last 12 months. - `response_rate` integer, nullable, required — The percentage of new inquiries and reservation requests a host responds to within 24 hours. - `response_time` number, nullable, required — The average host response rate in minutes for new inquiries and reservation requests from a guest. - `last_calendar_update` string, date, required — The date that the Listing's calendar was last scraped in `YYYY-MM-DD` format. - `last_scraped_date` string, date, required — The date that the Listing was last scraped in `YYYY-MM-DD` format. - `ratings` ListingRatings, required — The ratings for the Listing. - `overall_rating` number, nullable, required — Overall rating of the Listing from a scale of 0 to 5. - `airbnb_accuracy_rating` number, nullable, required — Average accuracy rating of the Listing on a scale of 0 to 5. - `airbnb_cleanliness_rating` number, nullable, required — Average cleanliness rating of the Listing on a scale of 0 to 5. - `airbnb_checkin_rating` number, nullable, required — Average checkin rating for the Listing on a scale of 0 to 5. - `airbnb_communication_rating` number, nullable, required — Average communication rating for the Listing on a scale of 0 to 5. - `airbnb_location_rating` number, nullable, required — Average location rating of the Listing on a scale of 0 to 5. - `airbnb_value_rating` number, nullable, required — Average value rating of the Listing on a scale of 0 to 5. - `platforms` Platforms, required — The IDs for the supported platforms that the Listing is hosted on. - `airbnb_host_id` string, nullable, required — ID for the Host on Airbnb. - `airbnb_property_id` string, nullable, required — ID for the Listing on Airbnb. - `airbnb_property_url` string, required — URL for the Listing on Airbnb. - `vrbo_property_id` string, nullable, required — ID for the Listing on Vrbo. - `vrbo_property_url` string, required — URL for the Listing on Vrbo. - `booking_property_id` string, nullable, required — ID for the Listing on Booking.com. - `booking_property_url` string, nullable, required — URL for the Listing on Booking.com. - `amenities` Amenities, required — The amenities that the Listing claims are available. - `has_aircon` boolean, required — Whether the listing has Air Conditioning. - `has_breakfast` boolean, required — Whether the listing offers Breakfast. - `has_cable_tv` boolean, required — Whether the listing has Cable Television. - `has_doorman` boolean, required — Whether the listing has a Doorman. - `has_dryer` boolean, required — Whether the listing has a Dryer. - `has_elevator` boolean, required — Whether the listing has an Elevator. - `has_family_friendly` boolean, required — Whether the listing is considered Family Friendly. - `has_guidebook` boolean, required — Whether the listing provides a Guidebook. - `has_gym` boolean, required — Whether the listing has a Gym. - `has_handicap_access` boolean, required — Whether the listing has Handicap Access. - `has_heating` boolean, required — Whether the listing has Heating. - `has_hottub` boolean, required — Whether the listing has a Hot tub. - `has_indoor_fireplace` boolean, required — Whether the listing has an Indoor Fireplace. - `has_intercom` boolean, required — Whether the listing has an Intercom. - `has_internet` boolean, required — Whether the listing has Internet. - `has_kitchen` boolean, required — Whether the listing has a Kitchen. - `has_parking` boolean, required — Whether the listing has onsite Parking. - `has_pets_allowed` boolean, required — Whether the listing allows Pets. - `has_pool` boolean, required — Whether the listing has a Pool. - `has_smoking` boolean, required — Whether the listing permits Smoking. - `has_suitable_for_events` boolean, required — Whether the listing is suitable for Events. - `has_tv` boolean, required — Whether the listing has a TV. - `has_washer` boolean, required — Whether the listing has a Washer. - `has_wireless_internet` boolean, required — Whether the listing has Wireless Internet. - `country` object — Information about the Country that the Listing belongs to. - `country_id` number — The AirDNA ID of the Country that the Listing belongs to. - `country_name` string — The name of the Country that the Listing belongs to. - `code` 'ad' | 'ae' | 'af' | 'ag' | 'ai' | 'al' | 'am' | 'ao' | 'aq' | 'ar' | 'as' | 'at' | 'au' | 'aw' | 'ax' | 'az' | 'ba' | 'bb' | 'bd' | 'be' | 'bf' | 'bg' | 'bh' | 'bi' | 'bj' | 'bl' | 'bm' | 'bn' | 'bo' | 'bq' | 'br' | 'bs' | 'bt' | 'bv' | 'bw' | 'by' | 'bz' | 'ca' | 'cc' | 'cd' | 'cf' | 'cg' | 'ch' | 'ci' | 'ck' | 'cl' | 'cm' | 'cn' | 'co' | 'cr' | 'cu' | 'cv' | 'cw' | 'cx' | 'cy' | 'cz' | 'de' | 'dj' | 'dk' | 'dm' | 'do' | 'dz' | 'ec' | 'ee' | 'eg' | 'eh' | 'er' | 'es' | 'et' | 'fi' | 'fj' | 'fk' | 'fm' | 'fo' | 'fr' | 'ga' | 'gb' | 'gd' | 'ge' | 'gf' | 'gg' | 'gh' | 'gi' | 'gl' | 'gm' | 'gn' | 'gp' | 'gq' | 'gr' | 'gs' | 'gt' | 'gu' | 'gw' | 'gy' | 'hk' | 'hm' | 'hn' | 'hr' | 'ht' | 'hu' | 'id' | 'ie' | 'il' | 'im' | 'in' | 'io' | 'iq' | 'ir' | 'is' | 'it' | 'je' | 'jm' | 'jo' | 'jp' | 'ke' | 'kg' | 'kh' | 'ki' | 'km' | 'kn' | 'kp' | 'kr' | 'kw' | 'ky' | 'kz' | 'la' | 'lb' | 'lc' | 'li' | 'lk' | 'lr' | 'ls' | 'lt' | 'lu' | 'lv' | 'ly' | 'ma' | 'mc' | 'md' | 'me' | 'mf' | 'mg' | 'mh' | 'mk' | 'ml' | 'mm' | 'mn' | 'mo' | 'mp' | 'mq' | 'mr' | 'ms' | 'mt' | 'mu' | 'mv' | 'mw' | 'mx' | 'my' | 'mz' | 'na' | 'nc' | 'ne' | 'nf' | 'ng' | 'ni' | 'nl' | 'no' | 'np' | 'nr' | 'nu' | 'nz' | 'om' | 'pa' | 'pe' | 'pf' | 'pg' | 'ph' | 'pk' | 'pl' | 'pm' | 'pn' | 'pr' | 'ps' | 'pt' | 'pw' | 'py' | 'qa' | 're' | 'ro' | 'rs' | 'ru' | 'rw' | 'sa' | 'sb' | 'sc' | 'sd' | 'se' | 'sg' | 'sh' | 'si' | 'sj' | 'sk' | 'sl' | 'sm' | 'sn' | 'so' | 'sr' | 'ss' | 'st' | 'sv' | 'sx' | 'sy' | 'sz' | 'tc' | 'td' | 'tf' | 'tg' | 'th' | 'tj' | 'tk' | 'tl' | 'tm' | 'tn' | 'to' | 'tr' | 'tt' | 'tv' | 'tw' | 'tz' | 'ua' | 'ug' | 'um' | 'us' | 'uy' | 'uz' | 'va' | 'vc' | 've' | 'vg' | 'vi' | 'vn' | 'vu' | 'wf' | 'ws' | 'xk' | 'ye' | 'yt' | 'za' | 'zm' | 'zw' — ISO Country Code in the format defined by ISO 3166-1 Alpha-2. - `market` object — Information about the Market that the Listing belongs to. - `id` string — The AirDNA ID of the Market that the Listing belongs to. - `name` string — The name of the Market that the Listing belongs to. - `market_type` 'urban_metro' | 'mountains_lakes' | 'coastal' | 'suburban' | 'rural' | 'mid_size_city' — The type of the Market/Submarket. - `market_score` number — The AirDNA market score for the Market that the Listing belongs to. - `country_code` 'ad' | 'ae' | 'af' | 'ag' | 'ai' | 'al' | 'am' | 'ao' | 'aq' | 'ar' | 'as' | 'at' | 'au' | 'aw' | 'ax' | 'az' | 'ba' | 'bb' | 'bd' | 'be' | 'bf' | 'bg' | 'bh' | 'bi' | 'bj' | 'bl' | 'bm' | 'bn' | 'bo' | 'bq' | 'br' | 'bs' | 'bt' | 'bv' | 'bw' | 'by' | 'bz' | 'ca' | 'cc' | 'cd' | 'cf' | 'cg' | 'ch' | 'ci' | 'ck' | 'cl' | 'cm' | 'cn' | 'co' | 'cr' | 'cu' | 'cv' | 'cw' | 'cx' | 'cy' | 'cz' | 'de' | 'dj' | 'dk' | 'dm' | 'do' | 'dz' | 'ec' | 'ee' | 'eg' | 'eh' | 'er' | 'es' | 'et' | 'fi' | 'fj' | 'fk' | 'fm' | 'fo' | 'fr' | 'ga' | 'gb' | 'gd' | 'ge' | 'gf' | 'gg' | 'gh' | 'gi' | 'gl' | 'gm' | 'gn' | 'gp' | 'gq' | 'gr' | 'gs' | 'gt' | 'gu' | 'gw' | 'gy' | 'hk' | 'hm' | 'hn' | 'hr' | 'ht' | 'hu' | 'id' | 'ie' | 'il' | 'im' | 'in' | 'io' | 'iq' | 'ir' | 'is' | 'it' | 'je' | 'jm' | 'jo' | 'jp' | 'ke' | 'kg' | 'kh' | 'ki' | 'km' | 'kn' | 'kp' | 'kr' | 'kw' | 'ky' | 'kz' | 'la' | 'lb' | 'lc' | 'li' | 'lk' | 'lr' | 'ls' | 'lt' | 'lu' | 'lv' | 'ly' | 'ma' | 'mc' | 'md' | 'me' | 'mf' | 'mg' | 'mh' | 'mk' | 'ml' | 'mm' | 'mn' | 'mo' | 'mp' | 'mq' | 'mr' | 'ms' | 'mt' | 'mu' | 'mv' | 'mw' | 'mx' | 'my' | 'mz' | 'na' | 'nc' | 'ne' | 'nf' | 'ng' | 'ni' | 'nl' | 'no' | 'np' | 'nr' | 'nu' | 'nz' | 'om' | 'pa' | 'pe' | 'pf' | 'pg' | 'ph' | 'pk' | 'pl' | 'pm' | 'pn' | 'pr' | 'ps' | 'pt' | 'pw' | 'py' | 'qa' | 're' | 'ro' | 'rs' | 'ru' | 'rw' | 'sa' | 'sb' | 'sc' | 'sd' | 'se' | 'sg' | 'sh' | 'si' | 'sj' | 'sk' | 'sl' | 'sm' | 'sn' | 'so' | 'sr' | 'ss' | 'st' | 'sv' | 'sx' | 'sy' | 'sz' | 'tc' | 'td' | 'tf' | 'tg' | 'th' | 'tj' | 'tk' | 'tl' | 'tm' | 'tn' | 'to' | 'tr' | 'tt' | 'tv' | 'tw' | 'tz' | 'ua' | 'ug' | 'um' | 'us' | 'uy' | 'uz' | 'va' | 'vc' | 've' | 'vg' | 'vi' | 'vn' | 'vu' | 'wf' | 'ws' | 'xk' | 'ye' | 'yt' | 'za' | 'zm' | 'zw' — ISO Country Code in the format defined by ISO 3166-1 Alpha-2. - `professionally_managed` boolean, required — Whether the Listing is professionally managed. - `property_manager` ListingPropertyManager, required — Information about the Property Manager for the Listing. - `property_manager_name` string, required — The name of the Property Manager. - `property_count` integer, required — The total number of Listings that the Property Manager has. - `review_count` integer, required — The total number of reviews across all of the Property Manager's Listings. - `currency` 'afn' | 'all' | 'dzd' | 'usd' | 'eur' | 'aoa' | 'xcd' | 'ars' | 'amd' | 'awg' | 'aud' | 'azn' | 'bsd' | 'bhd' | 'bdt' | 'bbd' | 'byn' | 'bzd' | 'xof' | 'bmd' | 'btn' | 'inr' | 'bob' | 'bov' | 'bam' | 'bwp' | 'nok' | 'brl' | 'bnd' | 'bgn' | 'bif' | 'cve' | 'khr' | 'xaf' | 'cad' | 'kyd' | 'clf' | 'clp' | 'cny' | 'cop' | 'cou' | 'kmf' | 'cdf' | 'nzd' | 'crc' | 'hrk' | 'cuc' | 'cup' | 'ang' | 'czk' | 'dkk' | 'djf' | 'dop' | 'egp' | 'svc' | 'ern' | 'etb' | 'fkp' | 'fjd' | 'xpf' | 'gmd' | 'gel' | 'ghs' | 'gip' | 'gtq' | 'gbp' | 'gnf' | 'gyd' | 'htg' | 'hnl' | 'hkd' | 'huf' | 'isk' | 'idr' | 'xdr' | 'irr' | 'iqd' | 'ils' | 'jmd' | 'jpy' | 'jod' | 'kzt' | 'kes' | 'kpw' | 'krw' | 'kwd' | 'kgs' | 'lak' | 'lbp' | 'lsl' | 'zar' | 'lrd' | 'lyd' | 'chf' | 'mop' | 'mga' | 'mwk' | 'myr' | 'mvr' | 'mru' | 'mur' | 'xua' | 'mxn' | 'mxv' | 'mdl' | 'mnt' | 'mad' | 'mzn' | 'mmk' | 'nad' | 'npr' | 'nio' | 'ngn' | 'omr' | 'pkr' | 'pab' | 'pgk' | 'pyg' | 'pen' | 'php' | 'pln' | 'qar' | 'mkd' | 'ron' | 'rub' | 'rwf' | 'shp' | 'wst' | 'stn' | 'sar' | 'rsd' | 'scr' | 'sle' | 'sgd' | 'xsu' | 'sbd' | 'sos' | 'ssp' | 'lkr' | 'sdg' | 'srd' | 'szl' | 'sek' | 'che' | 'chw' | 'syp' | 'twd' | 'tjs' | 'tzs' | 'thb' | 'top' | 'ttd' | 'tnd' | 'try' | 'tmt' | 'ugx' | 'uah' | 'aed' | 'usn' | 'uyi' | 'uyu' | 'uzs' | 'vuv' | 'vef' | 'ved' | 'vnd' | 'yer' | 'zmw' | 'zwl', required — ISO 4217 Currency Codes. - `status` Status, required — The Status object on the response envelope - `type` 'success' | 'error', required — The type of response provided by the server. - `response_id` string, required — A unique response code that can be used as a reference for support requests. - `message` string, required — A human-readable message that can provide more detail about the status of the request. ## Other responses - `400` — The request was invalid. - `404` — Failed to find data matching your request. - `500` — An internal server error occurred. --- [API](https://skmtc.net/airdna/apis/airdna-enterprise-api.md) · [All operations](https://skmtc.net/airdna/apis/airdna-enterprise-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/airdna/airdna-enterprise-api/versions/aeed3678926f/schema)