Versions
v5
Hotels
Pricing

Hotel Pricing

This page covers retrieving confirmed pricing for specific hotel rates.

Hotel Rate Pricing

GET /hotel/[sessionId]/pricing/[rateId]

This endpoint retrieves confirmed pricing information for a specific hotel rate. The rateId parameter should be the public identifier from an Enhanced Hotel Rate Info object obtained from the room details endpoint.

🛎 Use this endpoint to get final confirmed pricing before proceeding to booking. Pricing may differ from room details due to availability changes.

Request

GET /hotel/[sessionId]/pricing/[rateId]

Response

Returns a single Enhanced Hotel Rate Info object with confirmed pricing.

GET /hotel/[sessionId]/pricing/[rateId]
{
    "rate_description": {
        "start_date": "2025-10-08",
        "end_date": "2025-10-12",
        "tax_inclusive": false,
        "number_of_nights": 4,
        "refundable": false,
        "commissionable": true,
        "discount_codes": [],
        "pay_at_hotel": false,
        "payment_owner": "CLIENT",
        "cancellation": {
            "refundable": false,
            "penalties": [
                {
                    "amount": "886.59",
                    "currency": "CAD",
                    "deadline": "2025-10-10T06:59:00.000000Z",
                    "percentage": null
                }
            ]
        }
    },
    "rate_price": {
        "average_nightly_rate": "221.65",
        "average_nightly_rate_before_tax": "191.07",
        "amount_after_tax": "886.59",
        "amount_before_tax": "764.28",
        "fees": {
            "total": "0",
            "description": null,
            "breakdown": []
        },
        "taxes": {
            "total": "122.31",
            "description": {
                "text": "This charge includes estimated amounts the travel service provider (i.e. hotel, car rental company) pays for their taxes, and/or taxes that we pay, to taxing authorities on your booking (including but not limited to sales, occupancy, and value added tax). This amount may also include any amounts charged to us for resort fees, cleaning fees, and other fees and/or a fee we, the hotel supplier and/or the site you booked on, retain as part of the compensation for our and/or their services, which varies based on factors such as location, the amount, and how you booked. For more details, please see the terms and conditions.",
                "title": "Taxes and Fees",
                "link": null,
                "link_text": null
            },
            "breakdown": [
                {
                    "amount": 119.54,
                    "text": "Tax and service fee"
                },
                {
                    "amount": 2.77,
                    "text": "Property fee"
                }
            ]
        },
        "currency": "CAD",
        "commission": {
            "type": "FIXED",
            "amount": "33.82"
        }
    },
    "local_rate_price": null,
    "public": "945d542f-df33-448a-843f-e8cc079fab0e",
    "expireAt": "2025-09-25T19:42:37.065Z",
    "createdAt": "2025-09-25T17:45:34.074Z",
    "updatedAt": "2025-09-25T17:45:34.074Z"
}

Possible Errors

Status CodeErrorReasonReason Code
401UnauthorizedInvalid or missing API key
404Invalid Key ExceptionAPI key is invalid or inactiveORX_INVALID_API_KEY
404[Session Not Found]The specified session ID does not exist or has expiredORX_SESSION_NOT_FOUND
400[Validation Error]Invalid query parameters or search stringORX_VALIDATION_EXCEPTION
404Could not find hotel rate details