# Unifystays API

## Docs

- [Cancel Booking](https://docs.unifystays.com/api-reference/cancel-booking.md): Request an idempotent cancellation for a confirmed or on-hold booking.
- [List Cities](https://docs.unifystays.com/api-reference/cities.md): Retrieve the active city catalogue with search, country filtering, sorting, and pagination.
- [Create Booking](https://docs.unifystays.com/api-reference/create-booking.md): Create an idempotent hotel booking from a successful Unifystays prebooking response.
- [Destination Autocomplete](https://docs.unifystays.com/api-reference/destination-autocomplete.md): Find normalized places, cities, and hotels for a hotel-search destination picker.
- [Get Booking Details](https://docs.unifystays.com/api-reference/get-booking-details.md): Retrieve the complete itinerary, rooms, guests, pricing, supplier information, and booking timeline.
- [Get Booking Status](https://docs.unifystays.com/api-reference/get-booking-status.md): Retrieve the current lightweight unified status for one booking.
- [Get Hotel Content](https://docs.unifystays.com/api-reference/hotel-content.md): Retrieve static hotel content, policies, facilities, photos, and room-type details for one hotel.
- [Get Hotel Filters](https://docs.unifystays.com/api-reference/hotel-filters.md): Retrieve available search facets and counts for a place, city, or hotel's city.
- [Stream Room Updates](https://docs.unifystays.com/api-reference/hotel-room-stream.md): Consume server-sent room option events as active suppliers return availability for a hotel.
- [Get Room Options](https://docs.unifystays.com/api-reference/hotel-rooms.md): Start live supplier room retrieval for a selected hotel and receive bookable options with booking tokens.
- [List Bookings](https://docs.unifystays.com/api-reference/list-bookings.md): List and filter bookings for the current organization for support, reconciliation, and operational workflows.
- [List Nationalities](https://docs.unifystays.com/api-reference/nationalities.md): Load the canonical nationality list for guest selection and cache it for 30 days.
- [Overview](https://docs.unifystays.com/api-reference/overview.md): Base URLs, authentication, response conventions, and booking idempotency for the Unifystays API.
- [Prebook a Room](https://docs.unifystays.com/api-reference/prebook.md): Verify the selected room's current availability and price immediately before booking.
- [Search Hotels](https://docs.unifystays.com/api-reference/search-hotels.md): Search the unified hotel catalogue by destination, stay dates, room occupancy, filters, and pricing mode.
- [Get Search Price Updates](https://docs.unifystays.com/api-reference/search-price-updates.md): Poll a search session for fresh supplier prices and merge them into a visible result list.
- [Errors & Retries](https://docs.unifystays.com/errors.md): Handle error responses, request IDs, throttling, and safe retries.
- [Caching Strategy](https://docs.unifystays.com/guides/caching-strategy.md): Cache stable reference data efficiently while keeping hotel prices and booking availability current.
- [Hotel Booking Flow](https://docs.unifystays.com/guides/hotel-booking-flow.md): Build a complete search-to-booking experience with the unified Unifystays API.
- [Launch Checklist](https://docs.unifystays.com/guides/launch-checklist.md): Validate portal setup, security, booking behavior, and operational readiness before production traffic.
- [Portal & Environments](https://docs.unifystays.com/guides/portal-and-environments.md): Configure suppliers, environment-specific credentials, and secure API access in the Unifystays portal.
- [Introduction](https://docs.unifystays.com/index.md): Integrate once with a unified hotel API, then enable and manage suppliers from the Unifystays portal.
- [Quickstart](https://docs.unifystays.com/quickstart.md): Configure the sandbox and make your first Unifystays hotel search request.

## OpenAPI Specs

- [openapi](https://docs.unifystays.com/reference/openapi.json)