# Bookings

Endpoints for creating and managing bookings.

## Create a booking

 - [POST /v2/bookings](https://docs.bemyguest.com.sg/openapi/bookings/createbooking.md): Creates a new booking. 

> Before creating a booking, you should always check the availability and price using the  endpoint. 

The request body must contain all the necessary information for the booking, including customer details and product options.


## Get bookings

 - [GET /v2/bookings](https://docs.bemyguest.com.sg/openapi/bookings/getbookings.md): Retrieves a list of your bookings. You can filter the results by , , guest information (, , , ), , and . 

Pagination is also supported.


## Get booking status

 - [GET /v2/bookings/{uuid}](https://docs.bemyguest.com.sg/openapi/bookings/getbookingstatus.md): Retrieves the current status and details of a specific booking using its .

## Confirm or cancel booking

 - [PUT /v2/bookings/{uuid}/{status}](https://docs.bemyguest.com.sg/openapi/bookings/updatebookingstatus.md): Updates the status of a booking to either  or . 

- A new booking starts with the  status. 
- To confirm the booking and lock the inventory, you must update the status to . 
- Bookings in the  status will expire if not actioned within 5 days.
- To cancel a booking, a cancellation request is created and is subject to approval.


## Get vouchers

 - [GET /v2/bookings/{bookingUuid}/vouchers](https://docs.bemyguest.com.sg/openapi/bookings/getvouchers.md): Retrieves the vouchers for a specific booking. 

> Please note that the download links provided require authorization and should not be sent directly to the end customer. You must download the vouchers and distribute them yourself.