Booking Engine Guide
  • Mews Booking Engine Guide
  • Booking Engine Standalone
    • Getting started
    • Deeplinks
  • Booking Engine Widget
    • Getting started
    • Use cases
      • Prerequisites
      • Testing in the Demo environment
      • Using your own Date inputs
      • Multiple enterprises and pre-selected locations
      • Disabling widget caching
    • Advanced guide
    • Reference
    • Troubleshooting
  • Booking Engine API
    • Usage guidelines
      • Authentication
      • Requests
      • Responses
      • Environments
      • Images
      • Supported currency codes
      • Supported language codes
    • Use cases
      • Availability blocks
      • On session payments
      • Payment card authorization
      • Supporting payment cards
    • API Operations
      • Availability blocks
      • Configuration
      • Hotels
      • Payment cards
      • Reservations
      • Reservation groups
      • Services
      • Vouchers
    • Deprecations
  • Integrations
    • Google Tag Manager
    • Google Triggers Reference
    • Google Tag Manager Configuration
    • Google Analytics cross-domain tracking
  • FAQ
    • Ways to integrate
    • Migration off the mews.li domain
  • Changelog
    • Changelog 2024
    • Changelog 2023
    • Changelog 2022
    • Changelog 2021
    • Changelog 2020
Powered by GitBook
On this page
  • How to obtain availability block ID
  • How to work with availability blocks
  • Endpoints accepting availability block ID
  • Further information

Was this helpful?

  1. Booking Engine API
  2. Use cases

Availability blocks

PreviousUse casesNextOn session payments

Last updated 2 years ago

Was this helpful?

Availability blocks are fixed sets of inventory set aside from public availability for private groups such as wedding parties, travel agencies or corporate clients. If you have access to these private blocks, you can use them in the API. To use an availability block, you will need to obtain its availabilityBlockId.

How to obtain availability block ID

You can obtain a unique availability block ID from the Availability Blocks screen in Mews Operations, under 'Booking engine link'. Multiple IDs can be created, in case you have multiple booking engine instances.

Note: This functionality requires the property to have an Enterprise subscription.

How to work with availability blocks

Use to fetch details about your availability block. Check that the current date is between StartUtc and EndUtc to see if the availability block is valid, or the block has expired. Then you can supply availabilityBlockId into all the API operations that accept it (see below). To get the appropriate rate, filter with the rateId from the fetched availability block details. Only this rate should be available and bookable for this booking engine session.

Endpoints accepting availability block ID

Further information

For more information about availability blocks, the following guide may be helpful. You can also use the Search function to find other suitable content in the Mews Help system.

Creating availability blocks
Get reservations pricing
Create reservation group
Get availability blocks
Rates
Get availability