Cancel an Airbnb reservation
Automatically cancel an Airbnb reservation on airbnb.com. Cancel one of your Airbnb stay reservations by confirmation code, as the guest. Returns the refund Airbnb grants under the reservation's cancellation policy (what you paid, what comes back) and the reservation's status afterwards. A reservation that is already cancelled, or that Airbnb no longer lets you cancel, fails with a clear error and nothing changes. The host is told at once.
Input
code requiredReservation confirmation code, e.g. HMEZNST29K (Confirm an Airbnb booking returns it).
reasonId optionalAirbnb's cancellation reason code: 101 I no longer need accommodations (default), 102 I made the reservation by accident.
Default: "101"Output
code requiredstatus requiredThe reservation's status after the request, as Airbnb names it, e.g. CANCELED_BY_GUEST.
paid optionalrefund optionalThe total refund Airbnb showed before confirming.
FAQ
Search Airbnb listings
Search Airbnb stays in a location, with or without dates, with the filters Airbnb offers: guests, price range, room type, bedrooms, beds, bathrooms, Instant Book, guest favorites, amenities, property type, tags, host language and neighborhood (List Airbnb search filters gives their values). Returns one page of up to 18 listings (room id, name, price line, rating and review count, coordinates, badges, room details or next free dates, photos), the total count of matching listings, the number of pages (Airbnb stops at about 15) and the place Airbnb searched. A filter nothing matches returns an empty list. A location Airbnb cannot place fails with an error instead of returning its worldwide default list. Prices are in the currency you ask for (USD by default).
Get Airbnb listing
Get one Airbnb listing by room id: name, property and room type, capacity, ratings and per-category ratings, host, photos, description, sleeping arrangement, amenities (with the ones not included), things to know (house rules, safety, cancellation summary), location, and the 12-month availability calendar, every day with its available flag and minimum stay. With checkin and checkout it also returns the booking quote for those dates and guests (price lines and total, or available false with Airbnb's reason) and the cancellation policy's refund milestones. Airbnb opens calendars about 12 months ahead; dates beyond that fail with an error that says so. Prices are in the currency you ask for (USD by default). A listing that does not exist or was removed fails with an error that says so.
Prepare an Airbnb booking
Open Airbnb's confirm-and-pay page for a listing, dates and guests, signed in, and return what booking it would commit you to, without booking: the price lines and total, what is due today, the payment plans (pay in full, or part now and the rest on a date), the payment method Airbnb would charge, the cancellation policy, and whether the host requires a message. It books nothing and charges nothing. When the listing cannot be booked for those dates it fails with Airbnb's reason; Get Airbnb listing shows the free dates.
