# Availability search To find out whether a stay can be booked, request one of these (GET, no key needed). Both run the same search. As a plain HTML page (no JavaScript needed) - use this one if you read web pages: https://api.magnussonit.se/booking/v1/search-html?arrival=YYYY-MM-DD&departure=YYYY-MM-DD&guests=N Example: https://api.magnussonit.se/booking/v1/search-html?arrival=2027-06-01&departure=2027-06-05&guests=2 The page states the dates, the guests, available or not, the total price, the booking link and when it was checked. As JSON: https://api.magnussonit.se/booking/v1/search?arrival=YYYY-MM-DD&departure=YYYY-MM-DD&guests=N Example: https://api.magnussonit.se/booking/v1/search?arrival=2027-06-01&departure=2027-06-05&guests=2 - arrival: the day of arrival, today or later. - departure: the day of departure, after the arrival, at most 90 nights later. - guests: the number of guests, a whole number from 1. The JSON answer is: { arrival, departure, nights, guests, available, bookingUrl, price: { total, currency }, message }. "available" is true when every night is free in the booking system at the moment of the request. "bookingUrl" is present only then: it opens the checkout with the dates and the guests filled in - give it to the person who wants to book. "price" is what the whole stay costs, taxes and fees included, in the currency named. It is present only when available, and can be missing when the booking system gave no quote; the checkout then shows the price. A date or guest count that is not acceptable answers 400 with { error: "invalid_search", errors: [{ field, message }] }. 503 "search_unavailable" means the booking system could not be asked; try again later. The page /availability?arrival=YYYY-MM-DD&departure=YYYY-MM-DD&guests=N shows the same answer to a person; it needs JavaScript.