Retrieve Pricing
This endpoint retrieves the pricing settings for an Airbnb listing, including base rates, fees, and pricing rules.
Endpoint
POST
Header
app-id
string
Yes
Your application ID. Required for authentication.
Authorization
string
Yes
Your API key. for authorization. Required for authentication.
Content-Type
string
Yes
Must be set to application/json.
Attributes
hotelid alphanumeric (Required)
Specifies the required node hotelid containing the IT provider's hotel ID for which the provider wishes to add mapping information.
channelhotelid alphanumeric (Required)
Specifies the unique hotel ID used in the external distribution channel or PMS (Property Management System).
listingid numeric (Required)
Listing ID of the property allocated by Airbnb.
Request
Response
Success Response
Success Response - Body Elements
Status string
Indicates the result of the API call. Will be "Success" when the pricing setting details are retrieved successfully.
Data object
Contains the pricing-setting details for the specified listing.
pricing_setting object
The root node containing all pricing configuration for the Airbnb listing.
guest_fee_percent number
Percentage of guest fees charged by Airbnb.
price_per_extra_person number
Additional charge applied per extra guest beyond the included number of guests.
weekend_price number
Default nightly weekend price set for the listing.
listing_id string
Airbnb listing ID for which pricing settings are returned.
host_fee_percent number
Percentage of host service fees.
default_pricing_rules array
List of default rules applied for stay-length or advance-booking price adjustments.
rule_type string
The rule applied (e.g., stay length, booking window).
price_change number
Value of the price change; typically, negative for discounts.
threshold_one number
The threshold associated with the rule (e.g., minimum nights, days in advance).
price_change_type string
How the price change is interpreted (commonly PERCENT).
listing_currency string
Currency in which the listing prices are defined.
pass_through_taxes array
Taxes that are passed directly to Airbnb or the guest.
allowed_pass_through_taxes_collection_types array
Collection types that are supported for pass-through taxes.
standard_fees array
List of fees associated with the listing such as management fees or community fees.
offline boolean
Indicates whether the fee is charged offline.
amount number
Fee amount (percentage or flat).
charge_type string
Charging basis (e.g., PER_GROUP).
fee_type string
The type of the fee (e.g., PASS_THROUGH_MANAGEMENT_FEE).
amount_type string
Defines whether amount is a flat number or a percentage.
charge_period string
How often the fee is charged (e.g., PER_NIGHT, PER_BOOKING).
pass_through_taxes_collection_type string
Collection method applied for pass-through taxes.
default_daily_price number
Default daily price set for the listing.
default_pass_through_taxes_collection_type string
Default tax collection method if none is specified.
guests_included number
Number of guests included before extra-person charges apply.
offline_standard_fee_types array
Fee types that are processed offline if applicable.
Error Response
Error Response - Body Elements
Status string
Indicates the result of the API call.
Will be always "Fail" in case of an error response.
Errors object
The response error, the root element.
Code string
Specific error code that helps identify the type of error.
For example: "400" indicates a bad request.
ShortText string
A short description of the error.
Message string
The message in the response.
Last updated
Was this helpful?