Update Pricing
This endpoint updates 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.
listing_currency string (Optional)
Currency used for listing prices, in ISO 4217 format. Default value is USD.
default_daily_price numeric (Optional)
Default daily price for the listing, between 10 and 100,000 USD (inclusive).
weekend_price numeric (Optional)
Default price to apply for the weekend days, between 10 and 100,000 USD (inclusive).
guests_included numeric (Optional)
Number of guests permitted without any additional fees—default is 1. Infants (children under two years old) do not count towards the number of guests.
price_per_extra_person numeric (Optional)
Per guest per night price for each additional guest beyond the number specified as guests_included.
standard_fees array of objects (Optional)
Array of standard fees to be applied to the listing. Standard fees can be set as a percentage of the total reservation price or a flat amount per night.
fee_type enum (Required)
The type of fee being charged. Some fees are a flat rate, some are a percentage, and some are consumption fees charged each time a unit is consumed.
offline boolean (Optional)
Whether the standard fee is being charged at the time of the booking or offline. Default is false, meaning that the charge happens at the time of booking.
amount_type enum (Required)
Type of amount. Allowed: percent, flat.
amount numeric (Required)
Amount for fees.
charge_type enum (Optional)
Whether the fee applies per person, per guest, or per pet. Default value is PER_GROUP. A value of PER_PET is available exclusively for PASS_THROUGH_PET_FEE.
charge_period enum (Optional)
The time period for which the fee will be charged. Default value is PER_BOOKING.
default_pricing_rules array of objects (Optional)
Array of default pricing rules that are applied to the listing.
rule_type enum (Optional)
Type of rule you can apply to listing. Obtain the required enum values through the Master Data API.
price_change numeric (Optional)
Must be a negative float value, meaning price decrease.
price_change_type enum (Optional)
Change type of price. Must be set to PERCENT.
threshold_one numeric (Optional)
Specifies the X value in the X_DAYS rules.
Must be a multiple of 28 or 30 for BOOKED_BEYOND_AT_LEAST_X_DAYS (e.g., 30 for 1 month, 60 for 2 months, 120 for 3 months, etc.).
Must be equal to or less than 28 for BOOKED_WITHIN_AT_MOST_X_DAYS.
Cannot be negative.
Request
Response
Success Response
Success Response - Body Elements
Status string
Indicates the result of the API call. For a success response, the value is "Success".
Data object
Root container for all returned data elements.
pricing_setting object
Contains all pricing-related configurations applied to the listing.
standard_fees array of objects
List of all standard fees configured for the listing.
amount number
Fee amount (flat or percentage value depending on amount_type).
offline boolean
Indicates whether the fee is charged offline (true) or at booking time (false).
amount_type string
Defines whether the amount is a flat amount or a percent.
charge_type string
Determines whether the fee is charged per person, per group, etc. (e.g., PER_GROUP).
charge_period string
Frequency of fee application (e.g., PER_NIGHT, PER_BOOKING).
fee_type string
Specifies the fee type (e.g., PASS_THROUGH_MANAGEMENT_FEE).
pass_through_taxes_collection_type string
Indicates the active tax collection mode used for pass-through taxes for the listing.
Example: STACKED_AIRBNB_COLLECTED_TAX.
default_pass_through_taxes_collection_type string
Indicates the default tax collection method configured for the listing. This value is returned even if the host has not overridden it.
listing_currency string
The currency used for listing prices (ISO 4217 format).
guest_fee_percent numeric
The percentage of guest fees applied by Airbnb for this listing.
offline_standard_fee_types array
List of standard fee types that are configured to be charged offline. Returns an empty array if no offline fees are applied.
guests_included number
Number of guests included in the base price.
default_daily_price number
Default nightly price for the listing.
default_pricing_rules array of objects
List of default pricing rules applied to the listing.
rule_type string
Type of pricing rule applied.
price_change number
Negative value indicating a discount percentage or amount.
price_change_type string
Value type for the price change. Typically, PERCENT.
threshold_one number
Threshold used by rule type—typically number of days.
allowed_pass_through_taxes_collection_types array
Specifies the collection types supported for pass-through taxes.
Example: ["STACKED_AIRBNB_COLLECTED_TAX"].
host_fee_percent numeric
The percentage of host fees applied by Airbnb.
listing_id string
The Airbnb listing ID that pricing settings are applied to.
pass_through_taxes array
An array containing configured pass-through tax settings. Returns an empty array if no taxes are configured.
price_per_extra_person numeric
The applied per-extra-guest fee for this listing.
weekend_price numeric
The applied weekend price for this listing.
Message string
The message in the response.
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?