# Retrieve a booking by ID

Returns a specific booking by its unique ID.

Endpoint: GET /venues/bookings/{bookingId}
Version: 4.11.0-SNAPSHOT
Security: Staging, Production

## Path parameters:

  - `bookingId` (string, required)
    Unique identifier of the booking

## Header parameters:

  - `X-Partner-Reference` (string)
    Required for Bookable Agents. Specifies the partner reference for whom the booking is being made.
This header must contain a valid partner reference when making requests with the agent:write scope.
    Example: "bottomlessbrunch.com"

  - `X-Correlation-ID` (string)
    An optional ID which you can use to track transactions across multiple systems. It can have any value, but we recommend avoiding . characters.
Mirrored back in a response header.
    Example: "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA"

## Response 200 fields (application/json):

  - `id` (string)
    A globally unique identifier for the booking.

  - `compositeId` (string)
    A globally unique identifier for the venue/product.

  - `date` (string)
    The date of the booking.

  - `time` (string)
    The time of the booking.

  - `partySize` (integer)
    Number of guests for the booking.

  - `status` (string)
    Indicates the current status of the booking:
- Pending: The booking request has been received but not yet processed.
- InProgress: The enquiry has been received and assigned but is not yet confirmed.
- Confirmed: The booking has been confirmed.
- Cancelled: The booking was cancelled or rejected.
- Deleted: The booking has been deleted from the system.
- Lost: The booking was not completed before its scheduled date.
    Enum: "Pending", "InProgress", "Confirmed", "Cancelled", "Deleted", "Lost"

  - `firstName` (string)
    Guest's first name.

  - `lastName` (string)
    Guest's last name.

  - `email` (string)
    Email address of the guest.

  - `phone` (string)
    Phone number of the guest.

  - `company` (string)
    Company name if the booking is business-related.

  - `location` (object)

  - `location.area` (string)
    The general area where the venue is located Can be more than one separated by |.

  - `location.city` (string)
    The city where the venue is located.

  - `location.lat` (number)
    The latitude coordinate of the venue.

  - `location.lng` (number)
    The longitude coordinate of the venue.

  - `location.street` (string)
    The street address of the venue.

  - `location.postCode` (string)
    The postal code of the venue.

  - `location.gPlace` (string)
    The Google Place ID associated with the venue.

  - `duration` (integer)
    Duration of the booking in minutes.

  - `productType` (string)
    Type of product or service reserved.

  - `notes` (string)
    Additional notes for the booking.

  - `createdDate` (string)
    Timestamp when the booking was created.

  - `lastUpdate` (string)
    Timestamp of the last booking update.

  - `preorders` (array)
    List of preordered packages for the booking.

  - `preorders.packageId` (string, required)
    Unique identifier for the preordered package.

  - `preorders.name` (string)
    Package name
    Example: "*Pan roasted Padron peppers (V)"

  - `preorders.description` (string)
    Detailed package description
    Example: "5 items per guest: Salmon & celeriac on rye, Buttermilk fries chicken..."

  - `preorders.type` (string)
    Main package type
    Example: "food"

  - `preorders.quantity` (integer, required)
    Quantity of the preordered package.

  - `preorders.price` (number)
    Package price
    Example: 5.57

  - `preorderMenus` (array)
    List of preordered menus for the booking.

  - `preorderMenus.menuId` (string, required)
    Unique identifier for the preordered menu.

  - `partnerBookingId` (string)
    A custom booking identifier provided by the distributor (partner).  This ID is submitted when creating a booking via API or Portal and  serves as the partner’s own reference code for cross-system tracking.

  - `operatorBookingId` (string)
    The booking identifier generated by the operator’s RMS platform  (e.g., SevenRooms, Collins, Zonal). This ID uniquely identifies  the reservation within the operator’s system and is displayed in  the portal instead of the composite ID.

  - `reference` (string)
    Legacy reference code for the booking.  This field is deprecated and will be removed in future versions.  Please use operatorBookingId instead.

## Response default fields (application/json):

  - `type` (string)
    A URI reference [rfc9457] that identifies the problem type. This specification encourages that, when dereferenced, it provides human-readable documentation for the problem type (e.g., using HTML [W3C.REC-html5-20141028]). When this member is not present, its value is assumed to be "about:blank".

  - `title` (string, required)
    A short, human-readable summary of the problem type. It SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.

  - `status` (integer, required)
    The HTTP status code [rfc9457, Section 3.1.12] generated by the origin server for this occurrence of the problem.

  - `detail` (string)
    A human-readable explanation specific to this occurrence of the problem.

  - `instance` (string)
    A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.