Mavio example

A demo travel site, built on the Mavio API

Mavio sells hotel stays to travel partners through one API. This site is what a partner could build with it: search, listing pages, live room prices and checkout, using only the public API and a test key.

What's real here

The hotels, photos, reviews and prices all come from the production API, so what you see is what a partner's guests would see. The site uses a test key, though, and a test key never books anything. You can go all the way to checkout without being charged or holding a room.

Which calls each page makes

  • HomeGET /v1/listingsStays near you, found by a map box around your city
  • SearchGET /v1/listingsStays in a place, priced live once you add dates
  • Search filtersGET /v1/chainsThe hotel chains you can filter by
  • ListingGET /v1/listings/{id}Photos, rooms, amenities and policies
  • ListingGET /v1/listings/{id}/reviewsGuest reviews
  • Listing roomsPOST /v1/quotesLive offers for each room on your dates
  • CheckoutGET /v1/quotes/{id}The offer you picked, with its price and cancellation terms
  • Find my bookingGET /v1/bookingsYour booking, by its reference and the last name it's in

To see the calls behind any page, open the API call button in the bottom corner. It lists each request with its status code and timing.

How it's built

It's a TanStack Start app running on Cloudflare Workers. A typed client is generated from the OpenAPI spec, and the API key stays on the server: the browser only talks to this site, never to Mavio directly. That's the setup we recommend for partners too.

Build your own

Sign up for a test key, then follow the guides. Searching and pricing work the same way they do here.

Back to search