Check Availability

Last Update Date 13.07.2023

Request Url

http://api.stage.paximum.com/v1/search/checkavailability

Request Model

Attribute Type Required Description
OfferId String yes Selected offer id from search response

The information in this response is the latest information of the offer.
The board and roomTypes should be shown to the customer
DailyPrices only for information, your buying price is offer price.
Cancellation policy penalty date is UTC date and time is important, do not ignore it when calculating.

Request Sample

    
{"offerId":"12fb5389-d500-4b56-a887-3b08708d85fb"}

Response Model

Attribute Type Description
Rooms Array (Object) Offer rooms
Id String Offer id
ExpiresOn String Offer expiration date
SearchId String Search id
CheckInDate String Offer check in date
CheckOutDate String Offer check out date
HotelId String Hotel id
BoardId String Offer board Id (mealTypeId)
Board String Offer board name (mealTypeName)
BoardCategories Array (String) Board categories of the offer
Price Object Offer price
PriceBreakDown Array (Object) Daily prices
CancellationPolicies Array (Object) Cancel penalty informations
Supplements Array (Object) Supplement
IsSpecial Bool Special offer status
IsB2CPrice Bool If IsB2CPrice is true, this offer cannot be sold on B2C for less than minimum sale price
MinimumSalePrice Object Minimum sale price
IsAvailable Bool Offer availability status (Onrequest or available)
Notes Array (String) Imported notes about the offer
Restrictions Array (Restriction) Offer restrictions
Warnings Array (String) Offer warnings (PriceChanged, BoardChanged etc.)

Response Sample

    
{
    "expiresOn": "2023-07-13T13:22:25.7394952Z",
    "searchId": "eb4658f0-c35a-4d2f-82ef-8af9e655d915",
    "checkinDate": "2023-09-02T00:00:00Z",
    "checkoutDate": "2023-09-03T00:00:00Z",
    "hotelId": "326105",
    "id": "12fb5389-d500-4b56-a887-3b08708d85fb",
    "boardId": "50",
    "boardCategories": [
        "Breakfast"
    ],
    "board": "BED AND BREAKFAST",
    "rooms": [
        {
            "id": "811a69ef-a561-4d72-a7d3-dc721ccce589",
            "typeId": "3626",
            "type": "1 King Deluxe Corner Single Sofa Bed",
            "categories": [],
            "promotions": [],
            "travellers": [
                {
                    "type": "adult",
                    "age": 0,
                    "nationality": "DE"
                },
                {
                    "type": "adult",
                    "age": 0,
                    "nationality": "DE"
                }
            ],
            "price": {
                "amount": 104.1433,
                "currency": "EUR"
            }
        }
    ],
    "price": {
        "amount": 104.1433,
        "currency": "EUR"
    },
    "isB2CPrice": false,
    "minimumSalePrice": {
        "amount": 0.0,
        "currency": "EUR"
    },
    "priceBreakdown": [
        {
            "roomId": "811a69ef-a561-4d72-a7d3-dc721ccce589",
            "date": "2023-09-02T00:00:00Z",
            "price": {
                "amount": 104.1433,
                "currency": "EUR"
            }
        }
    ],
    "cancellationPolicies": [
        {
            "fee": {
                "amount": 104.1433,
                "currency": "EUR"
            },
            "afterDate": "2023-08-29T10:00:00Z"
        }
    ],
    "supplements": [],
    "isSpecial": false,
    "isAvailable": true,
    "notes": [
        "This rate is not applicable to United Arab Emirates market/country or passport holders otherwise the reservation will not be accepted or supplement fees can be charged on arrival.  Estimated total amount of taxes & fees for this booking:20.00 Utd. Arab Emir. Dirham payable on arrival.  Car park YES (With additional debit notes).Check-in hour 14:00-05:30.Children get free accommodation, meals payable on the spot 0 11.Identification card at arrival.Children share the bed with parents 1.Deposit on arrival.",
        "Conditions:",
        "1. If you have any active booking or cancelled and rebook with new price hotel will not confirm the last booking (TR: Aynı otelde aktif yada iptal edilip yeni fiyatla tekrar yapılan rezervasyon olması durumunda konfirme edilmeyecektir)",
        "2. Late Check-in. Some hotels do not have 24 hour reception service. If you are going to arrive to property after 08:00 pm or later please contact to hotel and inform them your arrival time. In case you'll arrive to hotel after midnight and didn't inform hotel could result cancelling your room by hotel and no-show.",
        "3. Requests. Bedding types for Double/Twin rooms, Specific room types cannot be guaranteed and are subject to availability at the time of check in. Extra bed depends on bedding type or condition of the hotel , there will be an additional charge for extra beds.",
        "4. Hotel surcharges. Resort fees, city taxes or any other surcharges due to the country regulations must be paid to the hotel directly. Our agency is not responsible for any extra hotel fees.",
        "5. Early check in & Late Check out. Hotels in general check the guests in to property after 02:00 pm and Check Out could be latest 11:00 am.  Hotel could charge extra for the special requests.",
        "Supplier original board:BED AND BREAKFAST",
        "Supplier original room(s): 1 King Deluxe Corner Single Sofa Bed"
    ],
    "restrictions": [
        {
            "type" : "MrCannotStay"
        }
    ],
    "isOwnProvider": false,
    "warnings": []
}