> ## Documentation Index
> Fetch the complete documentation index at: https://directdoc.hotellinkage.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Booking query

# Booking Query

Component allowing users to access reservation details by entering identification credentials.

<Note>
  🔍 **Component type:** Reservation lookup | **Fields required:** Booking ID + PIN code | **Redirects to:** Reservation management page
</Note>

## Overview

The `<bookingQuery>` component provides a secure way for guests to access their reservations without creating an account. It displays a modal with credential fields for quick booking lookup.

### Modal Fields

<CardGroup cols={2}>
  <Card title="Booking ID" icon="hashtag" color="#0ea5e9">
    Unique reservation identifier provided in confirmation email
  </Card>

  <Card title="PIN Code" icon="lock" color="#10b981">
    Security code sent with booking confirmation
  </Card>
</CardGroup>

## Basic Implementation

```html theme={null}
<div data-mirai-component="bookingQuery"></div>
```

## How It Works

<Steps>
  <Step title="User Access">
    Guest clicks on the booking query component to open the lookup modal
  </Step>

  <Step title="Credential Entry">
    User enters their reservation identifier (bookingId) and PIN code (pinCode)
  </Step>

  <Step title="Validation">
    System validates the entered credentials against the booking database
  </Step>

  <Step title="Redirection">
    If valid, user is automatically redirected to their reservation management page with full booking details
  </Step>
</Steps>

## Use Cases

<Tabs>
  <Tab title="Guest Services">
    <Card title="Self-Service Portal" icon="user">
      Allow guests to quickly access their reservations without creating an account. Perfect for:

      * Checking booking details
      * Viewing room information
      * Accessing hotel policies
    </Card>
  </Tab>

  <Tab title="Booking Management">
    <Card title="Modification Options" icon="calendar-check">
      Enable guests to manage existing reservations:

      * Modify dates (if allowed)
      * Update guest information
      * Cancel bookings
      * Add special requests
    </Card>
  </Tab>

  <Tab title="Quick Access">
    <Card title="Instant Lookup" icon="thumbs-up">
      Provide immediate access using minimal credentials:

      * No registration required
      * Works on any device
      * Secure PIN validation
      * Direct access to booking
    </Card>
  </Tab>
</Tabs>

## Implementation Examples

<Accordion title="Homepage Integration">
  ```html theme={null}
  <section class="guest-services">
    <h2>Access Your Reservation</h2>
    <p>Enter your booking details to view or manage your reservation</p>
    
    <div data-mirai-component="bookingQuery"></div>
  </section>
  ```
</Accordion>

<Accordion title="Custom Button Style">
  ```html theme={null}
  <div data-mirai-component="bookingQuery">
    <button class="custom-booking-btn">
      <i class="icon-calendar"></i> Manage My Booking
    </button>
  </div>
  ```
</Accordion>

<Accordion title="Footer Implementation">
  ```html theme={null}
  <footer>
    <div class="footer-links">
      <h4>Guest Services</h4>
      <ul>
        <li>
          <div data-mirai-component="bookingQuery">
            <a href="#">Check Reservation</a>
          </div>
        </li>
        <li><a href="/contact">Contact Us</a></li>
        <li><a href="/policies">Hotel Policies</a></li>
      </ul>
    </div>
  </footer>
  ```
</Accordion>

## Best Practices

<Warning>
  Ensure guests receive their booking ID and PIN code in the confirmation email. Without these credentials, they cannot access their reservation through this component.
</Warning>

### Placement Recommendations

| Location          | Purpose                           | Example                 |
| ----------------- | --------------------------------- | ----------------------- |
| Header/Navigation | Quick access for returning guests | Top-right corner link   |
| Homepage          | Prominent guest service feature   | Hero section or sidebar |
| Footer            | Standard site-wide access         | Guest services section  |
| Contact Page      | Support alternative               | Below contact form      |

***

<Info>
  💬 **Need help setting up booking query?** Contact us at [support@hotellinkage.com](mailto:support@hotellinkage.com)
</Info>