Update Listing
This endpoint updates an existing Airbnb listing with revised property details, location information, amenities, facilities, and pricing configuration.
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 contains 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 provided by Airbnb while listing was created.
roomid alphanumeric (Required)
Property's Room / Listing ID.
rateid alphanumeric (Required)
Property's rate ID.
multiplier numeric (Required)
Multiplier to increase / decrease rates. Both, absolute and percentage value is considered.
surcharge numeric (Required)
Additional Charges to added (if any).
occupancy numeric (Required)
Number of guests for this room/rate combination applies.
name alphanumeric (Required)
Listing’s title, maximum 50 characters. Can include a maximum of 5 capitalized letters.
property_type_group enum (Optional)
Generalized group of the property types. Obtain the required enum values through the Master Data API.
property_type_category enum (Optional)
Category of the property. Obtain the required enum values through the Master Data API.
room_type_category enum (Optional)
Room type category. Describes whether the listing is a shared room, private room, or entire home. Obtain the required enum values through the Master Data API.
listing_views enum (Optional)
Indicates the view of the listing. Obtain the required enum values through the Master Data API.
apt string (Optional)
Apartment/unit number. Non-special characters only.
street string (Optional)
Street address. Should include number, street name, and street suffix.
city string (Optional)
city of the listing.
state string (Optional)
State, territory, district, or province. For US states use the official two-letter abbreviation
lng numeric (Optional)
Longitude of the location of the listing.
lat numeric (Optional)
Latitude of the location of the listing.
zipcode string (Optional)
Zip or postal code.
country_code string (Optional)
Listing's capitalized, two-letter country code in ISO 3166-1 alpha-2 format.
directions string (Optional)
Directions to the property. Provided only to confirmed guests.
display_exact_location_to_guest enum (Optional)
Whether the map displays to guests the property's exact location or an approximate circle. Default is false.
person_capacity numeric (Optional)
Maximum number of guests that can be accommodated. Default is 1.
check_in_option object (Optional)
How guests will check in.
category enum (Required)
The type of check in the Host offers. Obtain the required enum values through the Master Data API.
instruction string (Required)
Instructions for guests on how to check in. Only shared with confirmed guests.
check_out_tasks object (Optional)
Tasks guests must complete while checking out. Obtain the required enum values through the Master Data API.
checkout task value as key
Request
Response
Success Response
Success Response - Body Elements
Status string
Indicates whether the API request was successful. Will always be "Success" in a successful response.
Data object
Contains the full details of the updated listing.
listing object
The root object containing all listing-level details such as address, availability, host info, facilities, and property attributes.
lat number
Latitude coordinate of the property.
lng number
Longitude coordinate of the property.
property_type_category string
Category of the property (e.g., hut, apartment).
property_type_group string
Generalized group of the property type (e.g., houses, apartments).
name string
Listing’s title.
check_out_tasks object
Tasks guests must complete during check-out. Each task contains:
is_present boolean
task_detail string
id string
The Airbnb-generated unique identifier for the listing.
reservation_issues array
Any reservation-related issues associated with the listing. Empty if none exist.
display_exact_location_to_guest boolean
Indicates whether the exact map location is shown to guests.
quality_standards object
Indicates Airbnb quality assessment for the listing (e.g., "state": "GOOD").
has_active_disaster boolean
Indicates whether the listing is in an active disaster zone.
categories array
Array of Airbnb categories associated with the listing.
country_code string
Two-letter country code in ISO 3166-1 alpha-2 format.
state string
State, territory, or region of the property.
person_capacity number
Maximum number of guests allowed.
listing_views array
Array indicating views from the property (e.g., "BAY_VIEW").
host_roles array
Details about listing hosts, including:
is_primary_host boolean
user_id string
type string (OWNER/CO-HOST)
is_super_host boolean
directions string
Guest directions to the property.
city string
City of the property.
tier string
Airbnb tier for the listing (e.g., marketplace).
has_availability boolean
Indicates whether the listing is currently active and available.
check_in_option object
Check-in instructions for guests:
category string
instruction string
street string
Street address of the property.
room_type_category string
Type of room offered (e.g., shared_room, private_room, entire_home).
synchronization_category string
The synchronization level of the listing (e.g., sync_all).
apt string
Apartment or unit number, if applicable.
facilities array
Array of facilities available at the property. Each object contains:
facility_id number
is_available boolean
Optional instances array with key and value.
Message string
Descriptive message about the result of the request. Example: "Listing updated successfully".
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?