Quote Alteration

Prices a change to a confirmed Airbnb reservation before it is sent: what the guest would pay, what Airbnb takes and what the host gets, next to the booking as it is. Nothing is sent to the guest, so call it as often as the host edits the change. Takes the same body as /api/requestAlteration/{reservationID}; send only what changes.
Airbnb prices the new dates and guests itself. With a totalPrice, proposed is priced at that total and airbnbPriced holds Airbnb's own price for the same stay, so the two can be shown side by side. unavailableDates lists nights the new dates share with another booking on the listing.
Airbnb only, like /api/requestAlteration/{reservationID}. The reservation must have source "Airbnb" and status "accepted", and its stay must not have ended. Requires the reservations:read scope.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

_id of the Airbnb reservation

Body Params

A change to a confirmed Airbnb reservation. Send only what changes; anything left out keeps the reservation's current value.

string

New check-in date (YYYY-MM-DD)

string

New check-out date (YYYY-MM-DD)

guests
object

New guest counts. A count left out keeps its current value.

integer

The new total in the listing's currency, as a whole number, including most of the listing's fees but not the cleaning fee. Leave it out to let Airbnb price the change.

Headers
string

Partner API key (deprecated — use OAuth 2.0 for new integrations)

string

User's authentication token (legacy). Use Authorization Bearer header for new integrations.

Responses

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json