# Bookings Bookings entity from the PMS, the booking is the main entity for a reservation, it contains all the information about the reservation, combined with a list of room stays which represent the individual stays in the units ## Search for bookings - [GET /api/v3/bookings](https://apidocs.resharmonics.com/apis/resharmonics-pms/bookings/listallbookings.md): Search for bookings via a variety of optional filters within the Property Management System (PMS). This endpoint allows you to filter bookings based on date ranges, statuses, unit IDs, booking contact IDs, and other criteria, providing a flexible way to retrieve specific booking information as needed. ## Create a booking/enquiry - [POST /api/v3/bookings](https://apidocs.resharmonics.com/apis/resharmonics-pms/bookings/createbooking.md): This endpoint is used to create a new booking with room stays in a ENQUIRY status. If 'reserveForMinutes' is specified the availability will be held for the number of minutes specified. Once the booking is created use the 'updateStatuses' endpoint to change the status to PENDING, CONFIRMED or CHECKED_IN. ## Create a payment record against a booking. - [POST /api/v3/bookings/{bookingId}/payments](https://apidocs.resharmonics.com/apis/resharmonics-pms/bookings/reconcilebookingpayments.md): Creates a payment record against a booking. The payment record will be reconciled against any outstanding invoices. Where necessary invoices will be auto posted. The payDueBefore parameter can be used to specify invoices up to a certain date to be paid. If there is insufficient outstanding on invoices, the payment is rejected. ## Update roomstay statuses on a specified booking. - [PUT /api/v3/bookings/{bookingId}/updateStatuses](https://apidocs.resharmonics.com/apis/resharmonics-pms/bookings/updatebookingstatus.md): This endpoint allows you to update the statuses of room stays associated with a specific booking within the Property Management System (PMS). Room stay statuses can include various states such as CONFIRMED, CHECKED_IN, CHECKED_OUT, etc. Updating these statuses helps in managing the booking lifecycle and ensuring accurate tracking of room occupancy and availability. ## Retrieve a booking and its associated data. - [GET /api/v3/bookings/{id}](https://apidocs.resharmonics.com/apis/resharmonics-pms/bookings/getbookingdtobyidentifier.md): Retrieve detailed information about a specific booking within the Property Management System (PMS). This includes all associated data such as room stays, invoices, notes, and tags. This endpoint ensures comprehensive access to all relevant booking details, facilitating efficient management and tracking of reservations. ## Get custom fields for a booking - [GET /api/v3/bookings/{id}/customFields](https://apidocs.resharmonics.com/apis/resharmonics-pms/bookings/getcustomfieldsforbooking.md): Retrieve all custom fields associated with a specific booking record in the booking module of the PMS. The response includes a list of custom fields, each containing details such as field name, type, and value. This endpoint is useful for accessing additional information stored in custom fields that are not part of the standard booking attributes. ## Retrieve the financial summary for a specified booking - [GET /api/v3/bookings/{id}/financialSummary](https://apidocs.resharmonics.com/apis/resharmonics-pms/bookings/getbookingpricebreakdown.md): Retrieve a detailed financial summary for a specific booking within the Property Management System (PMS). This includes all charges, payments, and adjustments related to the booking, providing a comprehensive overview of the booking's financial status. This endpoint ensures that all financial transactions linked to the booking are accessible, facilitating efficient financial management and tracking. ## Retrieve list of all notes for specified booking - [GET /api/v3/bookings/{id}/notes](https://apidocs.resharmonics.com/apis/resharmonics-pms/bookings/getnotesbybookingid.md): Retrieve a comprehensive list of all notes associated with a specific booking within the Property Management System (PMS). Notes provide detailed information about the booking, including comments, updates, and additional context. This endpoint ensures that all notes linked to the booking are accessible, facilitating efficient management and tracking of reservations. ## Record a note against a specified booking - [POST /api/v3/bookings/{id}/notes](https://apidocs.resharmonics.com/apis/resharmonics-pms/bookings/createbookingnote.md): Record a note against a specified booking within the Property Management System (PMS). This endpoint allows you to add comments, updates, or additional information related to a booking. Notes provide detailed context and history for the booking, ensuring comprehensive tracking and management of reservations. ## Retrieve list of all room stays for specified booking - [GET /api/v3/bookings/{id}/roomStays](https://apidocs.resharmonics.com/apis/resharmonics-pms/bookings/getroomstaysbybookingid.md): Retrieve a comprehensive list of all room stays associated with a specific booking within the Property Management System (PMS). This endpoint provides detailed information about each room stay, including the status, duration, and associated unit. It ensures that all room stays linked to the booking are accessible, facilitating efficient management and tracking of reservations. ## Retrieve list of all invoices for specified booking - [GET /api/v3/bookings/{id}/salesInvoices](https://apidocs.resharmonics.com/apis/resharmonics-pms/bookings/getinvoicesbybookingid.md): Retrieve a comprehensive list of all invoices associated with a specific booking within the Property Management System (PMS). This endpoint provides detailed financial information related to the booking, including all charges, payments, and adjustments. It ensures that all financial transactions linked to the booking are accessible, facilitating efficient financial management and tracking. ## Retrieve list of all tags for specified booking - [GET /api/v3/bookings/{id}/tags](https://apidocs.resharmonics.com/apis/resharmonics-pms/bookings/gettagsbybookingid.md): Retrieve a comprehensive list of all tags associated with a specific booking within the Property Management System (PMS). Tags provide additional metadata and categorization for bookings, allowing for better organization and filtering. This endpoint ensures that all tags linked to the booking are accessible, facilitating efficient management and tracking of reservations.