--- title: "Fetch Smart Rates for an Airbnb Listing." method: POST path: "/listing/{listingId}/smart_rates" tags: ["smart_rates"] --- # Fetch Smart Rates for an Airbnb Listing. `POST /listing/{listingId}/smart_rates` Given a Listing ID, this endpoint provides **up to 12 months** of recommended daily rates based on the requested pricing strategy. * Supports **Currency Conversion** for **non-USD** currencies. * By **default**, all currency data is in **USD**. * **Airbnb only.** Requests with `vrbo_*` or `bkng_*` Listing IDs are rejected with the envelope `"Smart Rates does not yet model Booking.com / Vrbo listings."`. ## 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. ## Request body - union - SmartRatesCustomRequestSchema — Use this **Custom** pricing strategy to receive Smart Rates influenced by your custom `base_rate` with our seasonality and demand-based modifiers. - `pricing_strategy` 'custom', required — The pricing strategy to use when calculating Smart Rates. - `base_rate` number, required — The starting rate before seasonality and other demand-based modifiers are applied. * This value **must** be in the requested `currency` for accurate results. - `min_rate` number — The minimum rate that can be recommended. * This value **must** be in the requested `currency` for accurate results. - `max_rate` number — The maximum rate that can be recommended. * This value **must** be in the requested `currency` for accurate results. - `num_months` integer, required — The number of months to receive Smart Rates for. - `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' — ISO 4217 Currency Codes. - `orphan_1_day_modifier` number — The percentage modifier for a single Orphan day. Represented as a decimal. * A **positive** value will apply a **premium** (increase). * e.g. `0.3` = `30%` premium. * A **negative** value will apply a **discount** (decrease). * e.g. `-0.3` = `30%` discount. - `orphan_2_day_modifier` number — The percentage modifier for 2 sequential Orphan days. Represented as a decimal. * A **positive** value will apply a **premium** (increase). * e.g. `0.3` = `30%` premium. * A **negative** value will apply a **discount** (decrease). * e.g. `-0.3` = `30%` discount. - SmartRatesBalanceRateRequestSchema — Use this **Balanced** strategy to receive Smart Rates that have an optimized balance between ADR and Occupancy. - `pricing_strategy` 'balanced', required — The pricing strategy to use when calculating Smart Rates. - `min_rate` number — The minimum rate that can be recommended. * This value **must** be in the requested `currency` for accurate results. - `max_rate` number — The maximum rate that can be recommended. * This value **must** be in the requested `currency` for accurate results. - `num_months` integer, required — The number of months to receive Smart Rates for. - `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' — ISO 4217 Currency Codes. - `orphan_1_day_modifier` number — The percentage modifier for a single Orphan day. Represented as a decimal. * A **positive** value will apply a **premium** (increase). * e.g. `0.3` = `30%` premium. * A **negative** value will apply a **discount** (decrease). * e.g. `-0.3` = `30%` discount. - `orphan_2_day_modifier` number — The percentage modifier for 2 sequential Orphan days. Represented as a decimal. * A **positive** value will apply a **premium** (increase). * e.g. `0.3` = `30%` premium. * A **negative** value will apply a **discount** (decrease). * e.g. `-0.3` = `30%` discount. - SmartRatesHighAdrRequestSchema — Use this **High ADR** strategy to receive Smart Rates that maximize a high average daily rate. - `pricing_strategy` 'high_adr', required — The pricing strategy to use when calculating Smart Rates. - `min_rate` number — The minimum rate that can be recommended. * This value **must** be in the requested `currency` for accurate results. - `max_rate` number — The maximum rate that can be recommended. * This value **must** be in the requested `currency` for accurate results. - `num_months` integer, required — The number of months to receive Smart Rates for. - `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' — ISO 4217 Currency Codes. - `orphan_1_day_modifier` number — The percentage modifier for a single Orphan day. Represented as a decimal. * A **positive** value will apply a **premium** (increase). * e.g. `0.3` = `30%` premium. * A **negative** value will apply a **discount** (decrease). * e.g. `-0.3` = `30%` discount. - `orphan_2_day_modifier` number — The percentage modifier for 2 sequential Orphan days. Represented as a decimal. * A **positive** value will apply a **premium** (increase). * e.g. `0.3` = `30%` premium. * A **negative** value will apply a **discount** (decrease). * e.g. `-0.3` = `30%` discount. - SmartRatesHighOccupancyRequestSchema — Use this **High Occupancy** strategy to receive Smart Rates that maximize occupancy. - `pricing_strategy` 'high_occupancy', required — The pricing strategy to use when calculating Smart Rates. - `min_rate` number — The minimum rate that can be recommended. * This value **must** be in the requested `currency` for accurate results. - `max_rate` number — The maximum rate that can be recommended. * This value **must** be in the requested `currency` for accurate results. - `num_months` integer, required — The number of months to receive Smart Rates for. - `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' — ISO 4217 Currency Codes. - `orphan_1_day_modifier` number — The percentage modifier for a single Orphan day. Represented as a decimal. * A **positive** value will apply a **premium** (increase). * e.g. `0.3` = `30%` premium. * A **negative** value will apply a **discount** (decrease). * e.g. `-0.3` = `30%` discount. - `orphan_2_day_modifier` number — The percentage modifier for 2 sequential Orphan days. Represented as a decimal. * A **positive** value will apply a **premium** (increase). * e.g. `0.3` = `30%` premium. * A **negative** value will apply a **discount** (decrease). * e.g. `-0.3` = `30%` discount. ## Response `200` Successful Smart Rates Response - object - `payload` SmartRatesResponseSchema, required — Response Schema for a Smart Rates Request. - `rates` object[], required — A list of daily recommended rates. - `date` string, date, required — Date string representing the day in the `YYYY-MM-dd` format. - `rate` integer, required — The recommended rate provided in the requested `currency`. - `attribution` object, required — The modifiers applied to the base rate to derive the recommended `rate`. * Negative numbers (`< 0`) represent a discount on the base rate. * Positive numbers (`> 0`) represent a premium to the base rate. - `demand_score` number, required — Premium/discount modifier based on the demand. - `holiday_or_event` number, required — Premium/discount modifier based on holiday or event. - `lead_time` number, required — Premium/discount modifier based on lead time. - `orphan` number, required — Premium/discount modifier for being an orphaned day. * If this day is a 1-day orphan, then the `orphan_1_day_modifier` will be returned. * If this day is a 2-day orphan, then the `orphan_2_day_modifier` will be returned. * If this day is **NOT** an orphan, then `0` will be returned. - `seasonality` number, required — Premium/discount modifier based on seasonality. - `day_of_week` number, required — Premium/discount modifier applied based on the day of the week. - `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` — Property has not been scraped in the last 30 days. - `500` — Unable to generate Smart Rates. --- [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)