# OpenBookings

## Docs

- [Magic-link sign-in endpoint — POST /api/auth](https://docs.openbookings.co/api/auth-magic-link.md): Reference for the OpenBookings magic-link authentication endpoint: request body, success response, expiry, error handling, and curl and fetch examples.
- [Authenticate requests to the OpenBookings API](https://docs.openbookings.co/api/authentication.md): How API clients authenticate with OpenBookings: the open hotel search endpoint, magic-link sign-in flow, social login, and session management.
- [Hotel search endpoint — GET /api/query](https://docs.openbookings.co/api/hotel-search.md): Complete reference for GET /api/query: all query parameters, response fields, pricing modifiers, error codes, and working curl and fetch examples.
- [OpenBookings REST API: endpoints and response format](https://docs.openbookings.co/api/overview.md): A concise reference for the OpenBookings REST API: base URL, available endpoints, response format, error codes, and rate-limiting guidance.
- [TypeScript types — OpenBookings API reference](https://docs.openbookings.co/api/types.md): TypeScript interface definitions for the OpenBookings API: HotelSearchInput, HotelSearchResult, ResolvedRoom, ModifierType, and AdjustmentType.
- [Authentication: sign in to OpenBookings](https://docs.openbookings.co/authentication.md): OpenBookings uses passwordless authentication. Sign in with a magic link sent to your email, or instantly with your existing Google or Apple account.
- [Browser settings and local preferences in OpenBookings](https://docs.openbookings.co/configuration/environment.md): How OpenBookings stores preferences in your browser, including background images and date formatting — no account settings required.
- [Third-party integrations powering OpenBookings](https://docs.openbookings.co/configuration/integrations.md): The services behind OpenBookings — destination search, interactive maps, authentication, and cookie consent — and what they mean for your experience.
- [Frequently Asked Questions — OpenBookings](https://docs.openbookings.co/faq.md): Answers to common questions about searching, booking, pricing, and signing in to OpenBookings, the open-source hotel booking platform.
- [Interactive Hotel Map — OpenBookings Guide](https://docs.openbookings.co/features/map.md): Explore hotels near your destination on an interactive map powered by MapLibre GL and MapTiler, showing property locations and distance from the city center.
- [How hotel pricing works in OpenBookings](https://docs.openbookings.co/features/pricing.md): Understand how OpenBookings calculates nightly rates, applies modifiers like weekend surcharges and early-bird discounts, and arrives at a final total price.
- [Search for Hotels — OpenBookings Guide](https://docs.openbookings.co/features/search.md): Learn how to search for hotels by destination, dates, and guest count using the OpenBookings web app and the GET /api/query REST endpoint.
- [Complete Booking Flow: Search to Confirmation](https://docs.openbookings.co/guides/booking-flow.md): Walk through every step of booking a hotel on OpenBookings — from entering your destination to confirming your reservation, with full API details.
- [Guest Management: Rooms, Adults, and Children](https://docs.openbookings.co/guides/guest-management.md): Learn how to configure the guest selector, understand room capacity constraints, and see how guest counts affect both availability and the price you pay.
- [Pricing Modifiers: How Your Final Price Is Calculated](https://docs.openbookings.co/guides/pricing-modifiers.md): How OpenBookings pricing modifiers work: day-of-week surcharges, length-of-stay discounts, early-bird deals, last-minute fees, and extra-guest surcharges.
- [What is OpenBookings? Hotel search platform overview](https://docs.openbookings.co/introduction.md): OpenBookings is an open-source hotel booking platform. Search hotels by destination, compare real-time prices, and book with passwordless authentication.
- [Get started with OpenBookings: your first hotel search](https://docs.openbookings.co/quickstart.md): Search for available hotels using the OpenBookings web app or the GET /api/query REST endpoint. Get to your first results in under 5 minutes.
- [Troubleshooting Guide — OpenBookings Help](https://docs.openbookings.co/troubleshooting.md): Step-by-step solutions for common OpenBookings issues: failed API requests, empty search results, missing magic link emails, and rate limiting.