Reservation API - Analysis HMS

Why Use the Reservation API?

The Analysis HMS Reservation API allows hotels to integrate their systems programmatically with our platform. By using this API, you can automate reservation processes, manage room availability, update bookings, and track guest check-ins, reducing manual errors and improving operational efficiency.

Developers can securely push reservations using a unique API key in the route and a Bearer token in the request header. This makes integrations safe, fast, and reliable.

Types of Data You Can Push

The Reservation API allows you to push a variety of data to manage hotel bookings efficiently. Below are the main types of information supported:

• Guest Details: Name, contact information, identification, special requests, and other personal data of the guest.
• Room & Booking Details: Room type, number of units, check-in/check-out dates, rate plans, and occupancy information.
• Advance Charges: Prepaid amounts, deposits, or advance payments related to the booking.
• Check-in Details: Actual check-in time, room allocation, guest status, and any notes.
• Cancellation Details: Cancellation date, reason, refund amount, and status.
• Payment & Billing Info: Total amount, tax, discounts, payment method, and invoice references.
• Additional Services: Extra services like meals, airport pickup, spa, or other amenities associated with the reservation.

Properly structuring this data in your JSON payload ensures smooth processing of reservations and prevents errors.

API Endpoint

Push a new reservation:
POST: https://analysishms.com/api/reservation/push/{api_key} Copy

Include your Bearer token in the request header as:
Authorization: Bearer <your_bearer_token>

Getting Your API Key

To get your unique API key and Bearer token, contact our support team:

• Email: pushpendra.analysis@outlook.com
• Phone/WhatsApp: 9161380170

After receiving your API key, you can start testing the Reservation API immediately.

Sample JSON for Reservation Push

Below is a partial JSON sample for your reference. For the complete JSON, download the sample file:

                {
                    "RoomStays": [
                        {
                            "RoomTypes": [
                                {
                                    "RoomDescription": {
                                        "Name": "DELUXE"
                                    },
                                    "NumberOfUnits": 1,
                                    "RoomTypeCode": "1103"
                                }
                            ],
                            "RatePlans": [
                                {
                                    "RatePlanCode": "7103",
                                    "RatePlanName": "AP (DLX)"
                                }
                            ],
                            ...
                        }
                    ]
                }
        

Testing in Postman

You can open this API directly in Postman using your API key and Bearer token:

Make sure to set the request type to POST and include the Authorization header:

                Authorization: Bearer <your_bearer_token>
                Content-Type: application/json
        

Step-by-Step Guide to Push Reservation

1. Contact support to get your API key and Bearer token.
2. Download the sample JSON and update with your booking details.
3. Send a POST request to /api/reservation/push/{api_key} with your Bearer token in the header.
4. Receive a JSON response confirming your reservation was successfully pushed.
5. Check the response for success or errors and handle accordingly in your system.

Benefits of Using Analysis HMS Reservation API

• Automates booking and reservation management.
• Reduces manual errors and improves operational efficiency.
• Secures requests with unique API key and Bearer token.
• Supports large-scale hotel operations with multiple room types and rate plans.
• Easy to integrate with existing hotel management systems or third-party apps.