Booking API Reference
Interactive API documentation for the Munu Booking API.
Gives the ability to list venues and their scenarios, view their available time slots, and place bookings for the specified time slots.
Contact
Bookings
Operations
List Bookings by External Reference
Lists bookings that contain either the extReferenceId and/or extReferenceNumber. Used for searching for specific bookings made by external systems.
Authorizations
clientCredentials Flow
"https://login.microsoftonline.com/{issuer}/oauth2/v2.0/token"Is made available as part of the onboading/integration process.
Parameters
Header Parameters
Client-specific key.
Query Parameters
Filter by bookings containing this external identification.
"fa8aa66d-680c-4da3-9fd1-f31d46fb336c"Filter by bookings containing this external reference.
"1262"Responses
Success
Create Booking
Reserves the capacity required to create this booking and returns a reference to it.
Authorizations
clientCredentials Flow
"https://login.microsoftonline.com/{issuer}/oauth2/v2.0/token"Is made available as part of the onboading/integration process.
Parameters
Header Parameters
Client-specific key.
Request Body
Responses
Success
Get Booking
Returns Booking for the specified bookingId.
Authorizations
clientCredentials Flow
"https://login.microsoftonline.com/{issuer}/oauth2/v2.0/token"Is made available as part of the onboading/integration process.
Parameters
Header Parameters
Client-specific key.
Responses
Success
Update Booking
Ability to update details about the booking. Partial update is not supported so a booking should be fetched using bookingId path parameter first before performing the update. Please note that the booking state can only be manipulated through a separate method.
Important
statuschanges are not supported usingPUTbut are instead modified usingPATCH. See theUpdate Booking Stateendpoint.
| *State | LEVEL | ACCESS | Description |
|---|---|---|---|
| REGISTERED | 0 | Default state for a newly created Booking. |
|
| UNCONFIRMED | 1 | External |
External state for when integrator has sent confirmation message to the guest, but have not got the response yet. |
| CONFIRMED | 2 | External |
External state for when the integrator has got a positive confirmation response from the guest. If the response is negative then the Booking should get the CANCELLED state. |
| WAITING | 3 | Internal, Read-Only |
Internal state, cannot be set through API. The Booking is active and cannot be updated by the API. |
| SEATED | 4 | Internal, Read-Only |
Internal state, cannot be set through API. The Booking is active and cannot be updated by the API. |
| BILL_PRINTED | 5 | Internal, Read-Only |
Internal state, cannot be set through API. The Booking is active and cannot be updated by the API. |
| CLOSED | 6 | Internal |
Internal state, cannot be set through API. |
| NO_SHOW | 6 | Internal |
Internal state, cannot be set through API. |
| CANCELLED | 6 | Internal, External |
The Booking has been cancelled. |
Authorizations
clientCredentials Flow
"https://login.microsoftonline.com/{issuer}/oauth2/v2.0/token"Is made available as part of the onboading/integration process.
Parameters
Header Parameters
Client-specific key.
Request Body
Responses
Success
Delete Booking
Endpoint only ment to delete temporary bookings, not reservations.
Authorizations
clientCredentials Flow
"https://login.microsoftonline.com/{issuer}/oauth2/v2.0/token"Is made available as part of the onboading/integration process.
Parameters
Header Parameters
Client-specific key.
Responses
OK
Update Booking Status
Changes the state of a Booking. Only a few of the states are available to be set through the API. The others are set through other processes.
State Flow
States can only increase in level.
| State | LEVEL | SET BY | ACCESS | Description |
|---|---|---|---|---|
| REGISTERED | 0 | Default state for a newly created Booking. |
||
| UNCONFIRMED | 1 | External |
State set externally for when integrator has sent confirmation message to the guest, but have not got the response yet. | |
| CONFIRMED | 2 | External |
State set externally for when the integrator has got a positive confirmation response from the guest. If the response is negative then the Booking should get the CANCELLED state. |
|
| WAITING | 3 | Internal |
BLOCKED |
Set internally, the Booking is blocked from changes through the API. |
| SEATED | 4 | Internal |
BLOCKED |
Set internally, the Booking is blocked from changes through the API. |
| BILL_PRINTED | 5 | Internal |
BLOCKED |
Set internally, the Booking is blocked from changes through the API. |
| CLOSED | 6 | Internal |
READ-ONLY |
Set internally, the Booking has been finalized and can no longer be changed. |
| NO_SHOW | 6 | Internal |
READ-ONLY |
Set internally, the Booking has been finalized and can no longer be changed. |
| CANCELLED | 6 | Internal, External |
READ-ONLY |
Set internally or by the API. The Booking has been finalized and can no longer be changed. |
Authorizations
clientCredentials Flow
"https://login.microsoftonline.com/{issuer}/oauth2/v2.0/token"Is made available as part of the onboading/integration process.
Request Body
Responses
OK
Update Booking Timeslot
This endpoint gives the ability to change the timeslot for the booking.
Authorizations
clientCredentials Flow
"https://login.microsoftonline.com/{issuer}/oauth2/v2.0/token"Is made available as part of the onboading/integration process.
Parameters
Query Parameters
Request Body
Responses
OK
Create Waitlist
Authorizations
clientCredentials Flow
"https://login.microsoftonline.com/{issuer}/oauth2/v2.0/token"Is made available as part of the onboading/integration process.
Request Body
Responses
Created
Update Waitlist Status
Changes the state of a Waitlist. Only state CANCELLED is available.
Authorizations
clientCredentials Flow
"https://login.microsoftonline.com/{issuer}/oauth2/v2.0/token"Is made available as part of the onboading/integration process.
Request Body
Responses
OK
List Venues
Lists all available venues.
Authorizations
clientCredentials Flow
"https://login.microsoftonline.com/{issuer}/oauth2/v2.0/token"Is made available as part of the onboading/integration process.
Parameters
Header Parameters
Client-specific key.
Responses
Success
List Time Slots
Generates a list of possible time slots for the given guestCount and date. This list represents TimeSlots for which it might be possible to create a Booking.
Important
TimeSlotsare not static, but rather generated based onVenueconfiguration. If the configuration changes then the list can look completely different. Treat it as a realtime result for which aBookingcan be placed right now. Once aBookinghas been placed it is holding capacity at theVenue, it is not reserving aTimeSlot.
Authorizations
clientCredentials Flow
"https://login.microsoftonline.com/{issuer}/oauth2/v2.0/token"Is made available as part of the onboading/integration process.
Parameters
Header Parameters
Client-specific key.
Query Parameters
Date in ISO-8601 format YYYY-MM-DD.
"2023-01-15""date"Number of guests.
2Filters result from a specific time of day.
"07:15:00""time"Filters result to a specific time of day.
"14:45:00""time"Filter response by scenarioId.
Responses
Success
List Availability
Lists availability for the Venue for the specified numberOfDays starting with fromDate. The availability for a Venue are described on two levels; venueStatus and reservableState. The former describes if a venue is open for business, while the latter describes if it is possible to create any bookings on at least one scenario right now.
A maximum of 31 days are returned with 1 being the default if nothing is specified. If no fromDate is specified it will default to the current date.
venueStatus
| State | Description |
|---|---|
| OPEN | The Venue is open for business. This does not however mean that there are available scenarios to book from. |
| CLOSED | The Venue is closed, either because of planned opening hours or because an opening hour deviation has occured (temporary closed). |
reservableState
| State | Description |
|---|---|
| AVAILABLE | The Venue has one or more scenarios which are open and have available TimeSlots. |
| NOT_AVAILABLE | All of the scenarios for the Venue are NOT_AVAILABLE. |
| FULLY_BOOKED | One or more scenarios are FULLY_BOOKED and there are no AVAILABLE scenarios. |
scenarios[].status
| State | Description |
|---|---|
| AVAILABLE | The Scenario has available capacity. |
| NOT_AVAILABLE | The bookable capacity is either set to 0, no tables have been defined, or the Scenario is temporarily blocked for booking. |
| FULLY_BOOKED | The Scenario has no available capacity. |
Authorizations
clientCredentials Flow
"https://login.microsoftonline.com/{issuer}/oauth2/v2.0/token"Is made available as part of the onboading/integration process.
Parameters
Query Parameters
Date in ISO-8601 format YYYY-MM-DD. Defaults to todays date if nothing else is specified.
"2023-01-01""date"Number of days to return.
14"date"1311Number of guests.
1Filter response by reservableState value.
"AVAILABLE""NOT_AVAILABLE""FULLY_BOOKED"Filter response by venueStatus value.
"OPEN""CLOSED"Filter response by scenarioId.
Responses
List DayTimeSlots
Authorizations
clientCredentials Flow
"https://login.microsoftonline.com/{issuer}/oauth2/v2.0/token"Is made available as part of the onboading/integration process.
Responses
OK