--- title: "Verify hotel price" method: POST path: "/v2/hotel/price-check" tags: ["Hotel"] --- # Verify hotel price `POST /v2/hotel/price-check` ## Request - Base URL: `https://api-ext-sboxmeta.partners.spotnana.com` - URL: `https://api-ext-sboxmeta.partners.spotnana.com/v2/hotel/price-check` - Auth: HTTP bearer Checks if the previously selected hotel price has been modified. To indicate the change in hotel price, the `priceChange` field in the response will be set to `true` and the `price` object will contain the latest hotel price. If the price remains unchanged, the `priceChange` field will be set as `false` and the `price` object will contain the original price. ## Request body - HotelPriceCheckRequest: Defines the structure of a hotel price check request. - `priceValidateKey` string, required: The key used to validate the price. - `tripId` string: The trip ID for the booking. ## Response `200` OK - HotelPriceCheckResponse: Defines the structure of a hotel price check response. - `bookingKey` string, required: The unique key used to make the hotel booking. - `timeout` integer, required: Timeout for the booking key in seconds. - `priceChange` boolean, required: Indicates if the price has changed. - `price` HotelRoomRate, required: Rate details for hotel room - `base` Money, required: Money object containing details such as the amount, the currency code, and the converted amount. - `amount` number, double, required: The numeric value for the amount of money. - `currencyCode` string, required: The 3-letter currency code for the money amount (defined using ISO 4217 standard). - `convertedAmount` number, double: The converted currency and amount that has been converted (if a currency conversion has been requested). For example, if the call requests that money be sent in a specified currency (because the frontend requested the backend to send money in the user's preferred currency). - `convertedCurrency` string: The 3-letter currency code for the converted currency (defined using ISO 4217 standard). - `otherCoinage` object[]: List of the dollar amount in other coinage systems like reward points, cryptocurrency etc. - `coinageCode` 'PAYMENT_METHOD_UNKNOWN' | 'CREDIT_CARD' | 'BREX_POINTS' | 'CASH' | 'QANTAS_POINTS' | 'VENDOR_PROGRAM_PAYMENT' | 'DELAYED_INVOICING' | 'FLIGHT_CREDITS' | 'QANTAS_TRAVEL_FUND' | 'CUSTOM_VIRTUAL_PAYMENT' | 'FLIGHT_PASS' | 'MISCELLANEOUS_CREDIT_ORDER' | 'NO_PREPAYMENT' | 'DELAYED_PAYMENT': Payment method - `amount` number, double - `conversionRate` number, double: 1 coin in this system equals to how many currency value - `preferredCurrencyConversionRate` number, double: 1 coin in this system equals to how many currency value - `otherCoinageMetadata` FlightPassPaymentMetadataWrapper: Wrapper for Flight Pass payment metadata. - `metadataType` string: Discriminator field for polymorphic deserialization - `flightPassMetadata` FlightPassPaymentMetadata, required: Metadata specific to Flight Pass payment method in OtherCoinage. - `flightPassNumber` string: Flight pass number - `flightPassAmounts` FlightPassPaymentAmounts: Fare breakdown for the flight pass booking. - … - `tax` Money, required: Money object containing details such as the amount, the currency code, and the converted amount. - `amount` number, double, required: The numeric value for the amount of money. - `currencyCode` string, required: The 3-letter currency code for the money amount (defined using ISO 4217 standard). - `convertedAmount` number, double: The converted currency and amount that has been converted (if a currency conversion has been requested). For example, if the call requests that money be sent in a specified currency (because the frontend requested the backend to send money in the user's preferred currency). - `convertedCurrency` string: The 3-letter currency code for the converted currency (defined using ISO 4217 standard). - `otherCoinage` object[]: List of the dollar amount in other coinage systems like reward points, cryptocurrency etc. - `coinageCode` 'PAYMENT_METHOD_UNKNOWN' | 'CREDIT_CARD' | 'BREX_POINTS' | 'CASH' | 'QANTAS_POINTS' | 'VENDOR_PROGRAM_PAYMENT' | 'DELAYED_INVOICING' | 'FLIGHT_CREDITS' | 'QANTAS_TRAVEL_FUND' | 'CUSTOM_VIRTUAL_PAYMENT' | 'FLIGHT_PASS' | 'MISCELLANEOUS_CREDIT_ORDER' | 'NO_PREPAYMENT' | 'DELAYED_PAYMENT': Payment method - `amount` number, double - `conversionRate` number, double: 1 coin in this system equals to how many currency value - `preferredCurrencyConversionRate` number, double: 1 coin in this system equals to how many currency value - `otherCoinageMetadata` FlightPassPaymentMetadataWrapper: Wrapper for Flight Pass payment metadata. - `metadataType` string: Discriminator field for polymorphic deserialization - `flightPassMetadata` FlightPassPaymentMetadata, required: Metadata specific to Flight Pass payment method in OtherCoinage. - `flightPassNumber` string: Flight pass number - `flightPassAmounts` FlightPassPaymentAmounts: Fare breakdown for the flight pass booking. - … - `roomFees` RoomFee[] - `amount` Money, required: Money object containing details such as the amount, the currency code, and the converted amount. - `amount` number, double, required: The numeric value for the amount of money. - `currencyCode` string, required: The 3-letter currency code for the money amount (defined using ISO 4217 standard). - `convertedAmount` number, double: The converted currency and amount that has been converted (if a currency conversion has been requested). For example, if the call requests that money be sent in a specified currency (because the frontend requested the backend to send money in the user's preferred currency). - `convertedCurrency` string: The 3-letter currency code for the converted currency (defined using ISO 4217 standard). - `otherCoinage` object[]: List of the dollar amount in other coinage systems like reward points, cryptocurrency etc. - `coinageCode` 'PAYMENT_METHOD_UNKNOWN' | 'CREDIT_CARD' | 'BREX_POINTS' | 'CASH' | 'QANTAS_POINTS' | 'VENDOR_PROGRAM_PAYMENT' | 'DELAYED_INVOICING' | 'FLIGHT_CREDITS' | 'QANTAS_TRAVEL_FUND' | 'CUSTOM_VIRTUAL_PAYMENT' | 'FLIGHT_PASS' | 'MISCELLANEOUS_CREDIT_ORDER' | 'NO_PREPAYMENT' | 'DELAYED_PAYMENT': Payment method - `amount` number, double - `conversionRate` number, double: 1 coin in this system equals to how many currency value - `preferredCurrencyConversionRate` number, double: 1 coin in this system equals to how many currency value - `otherCoinageMetadata` FlightPassPaymentMetadataWrapper: Wrapper for Flight Pass payment metadata. - `metadataType` string: Discriminator field for polymorphic deserialization - `flightPassMetadata` FlightPassPaymentMetadata, required: Metadata specific to Flight Pass payment method in OtherCoinage. - … - `feeInclusions` string[]: Amenities included as part of the fee - `displayFee` boolean: Flag to determine whether to explicitly show this fee type on UI - `feeType` 'UNKNOWN' | 'BED_TAX' | 'CITY_HOTEL_FEE' | 'CITY_TAX' | 'COUNTRY_TAX' | 'ENERGY_TAX' | 'FEDERAL_TAX' | 'FOOD_AND_BEVERAGE_TAX' | 'LODGING_TAX' | 'MAINTENANCE_FEE' | 'OCCUPANCY_TAX' | 'PACKAGE_FEE' | 'RESORT_FEE' | 'SALES_TAX' | 'SERVICE_CHARGE' | 'STATE_TAX' | 'SURCHARGE' | 'TOTAL_TAX' | 'TOURISM_TAX' | 'VAT_GST_TAX' | 'SURPLUS_LINES_TAX' | 'INSURANCE_PREMIUM_TAX' | 'APPLICATON_FEE' | 'EXPRESS_HANDLING_FEE' | 'EXEMPT' | 'STANDARD' | 'ZERO_RATED' | 'MISCELLANEOUS' | 'ROOM_TAX' | 'EARLY_CHECKOUT_FEE' | 'COUNTRY_TAXES' | 'EXTRA_PERSON_CHARGE' | 'BANQUET_SERVICE_FEE' | 'ROOM_SERVICE_FEE' | 'LOCAL_FEE' | 'GOODS_AND_SERVICES_TAX' | 'VALUE_ADDED_TAX' | 'CRIB_FEE' | 'ROLLAWAY_FEE' | 'ASSESSMENT_LICENSE_TAX' | 'PET_SANITATION_FEE' | 'NOT_KNOWN' | 'CHILD_ROLLAWAY_CHARGE' | 'CONVENTION_TAX' | 'EXTRA_CHILD_CHARGE' | 'STANDARD_FOOD_AND_BEVERAGE_GRATUITY' | 'NATIONAL_GOVERNMENT_TAX' | 'ADULT_ROLLAWAY_FEE' | 'BEVERAGE_WITH_ALCOHOL' | 'BEVERAGE_WITHOUT_ALCOHOL' | 'TOBACCO' | 'FOOD' | 'TOTAL_SURCHARGES' | 'STATE_COST_RECOVERY_FEE' | 'MISCELLANEOUS_FEE' | 'DESTINATION_AMENITY_FEE' | 'REFUNDABLE_PET_FEE' | 'CHARITY_SUPPORT_FEE' | 'LOCAL_AMENITY_USAGE_MAINTENANCE_FEE' | 'CONVENTION_TOURISM_FEE' | 'DESTINATION_MARKETING_FEE' | 'HOTEL_DEVELOPMENT_FEE' | 'EVENT_FEE' | 'SUSTAINABILITY_FEE' | 'TRANSPORTATION_TRANSFER_FEE' | 'INSURANCE_FEE' | 'LOCAL_GOVERNMENT_FEE' | 'LOCAL_ORDINANCE_SURCHARGE' | 'GUARANTEED_EARLY_CHECK_IN_FEE' | 'GUARANTEED_LATE_CHECK_OUT_FEE' | 'MODIFICATION_FEE' | 'HOTEL_ANCILLARY_EARLY_CHECK_IN_FEE' | 'HOTEL_ANCILLARY_LATE_CHECK_OUT_FEE' | 'HOTEL_ANCILLARY_PET_FEE' | 'HOTEL_ANCILLARY_WIFI_FEE' | 'HOTEL_ANCILLARY_BREAKFAST_FEE' | 'HOTEL_ANCILLARY_PARKING_FEE' | 'HOTEL_ANCILLARY_MEAL_PLAN_FEE' | 'ACCESSIBILITY_EQUIPMENT_FEE' | 'TOURISM_MARKETING_FEE': Fees Type - `commission` Commission: Commision on rate - `amount` Money, required: Money object containing details such as the amount, the currency code, and the converted amount. - `amount` number, double, required: The numeric value for the amount of money. - `currencyCode` string, required: The 3-letter currency code for the money amount (defined using ISO 4217 standard). - `convertedAmount` number, double: The converted currency and amount that has been converted (if a currency conversion has been requested). For example, if the call requests that money be sent in a specified currency (because the frontend requested the backend to send money in the user's preferred currency). - `convertedCurrency` string: The 3-letter currency code for the converted currency (defined using ISO 4217 standard). - `otherCoinage` object[]: List of the dollar amount in other coinage systems like reward points, cryptocurrency etc. - `coinageCode` 'PAYMENT_METHOD_UNKNOWN' | 'CREDIT_CARD' | 'BREX_POINTS' | 'CASH' | 'QANTAS_POINTS' | 'VENDOR_PROGRAM_PAYMENT' | 'DELAYED_INVOICING' | 'FLIGHT_CREDITS' | 'QANTAS_TRAVEL_FUND' | 'CUSTOM_VIRTUAL_PAYMENT' | 'FLIGHT_PASS' | 'MISCELLANEOUS_CREDIT_ORDER' | 'NO_PREPAYMENT' | 'DELAYED_PAYMENT': Payment method - `amount` number, double - `conversionRate` number, double: 1 coin in this system equals to how many currency value - `preferredCurrencyConversionRate` number, double: 1 coin in this system equals to how many currency value - `otherCoinageMetadata` FlightPassPaymentMetadataWrapper: Wrapper for Flight Pass payment metadata. - `metadataType` string: Discriminator field for polymorphic deserialization - `flightPassMetadata` FlightPassPaymentMetadata, required: Metadata specific to Flight Pass payment method in OtherCoinage. - … - `commissionPercent` number, double: Commission percentage - `taxBreakdown` Tax[] - `amount` Money, required: Money object containing details such as the amount, the currency code, and the converted amount. - `amount` number, double, required: The numeric value for the amount of money. - `currencyCode` string, required: The 3-letter currency code for the money amount (defined using ISO 4217 standard). - `convertedAmount` number, double: The converted currency and amount that has been converted (if a currency conversion has been requested). For example, if the call requests that money be sent in a specified currency (because the frontend requested the backend to send money in the user's preferred currency). - `convertedCurrency` string: The 3-letter currency code for the converted currency (defined using ISO 4217 standard). - `otherCoinage` object[]: List of the dollar amount in other coinage systems like reward points, cryptocurrency etc. - `coinageCode` 'PAYMENT_METHOD_UNKNOWN' | 'CREDIT_CARD' | 'BREX_POINTS' | 'CASH' | 'QANTAS_POINTS' | 'VENDOR_PROGRAM_PAYMENT' | 'DELAYED_INVOICING' | 'FLIGHT_CREDITS' | 'QANTAS_TRAVEL_FUND' | 'CUSTOM_VIRTUAL_PAYMENT' | 'FLIGHT_PASS' | 'MISCELLANEOUS_CREDIT_ORDER' | 'NO_PREPAYMENT' | 'DELAYED_PAYMENT': Payment method - `amount` number, double - `conversionRate` number, double: 1 coin in this system equals to how many currency value - `preferredCurrencyConversionRate` number, double: 1 coin in this system equals to how many currency value - `otherCoinageMetadata` FlightPassPaymentMetadataWrapper: Wrapper for Flight Pass payment metadata. - `metadataType` string: Discriminator field for polymorphic deserialization - `flightPassMetadata` FlightPassPaymentMetadata, required: Metadata specific to Flight Pass payment method in OtherCoinage. - … - `taxCode` string: Tax code - `percentage` number, double: Tax amount to total amount - `description` string: Tax name or Tax Description - `includesCommission` boolean: Whether the rate includes commission ## Other responses - `401`: Unauthorized - `403`: Forbidden - `404`: The specified resource was not found. ## Changes - **2026-10-29** `65c527a9a98d`: 5 warning - added the new `DELAYED_PAYMENT` enum value to the `price/base/otherCoinage/items/coinageCode` response property for the response status `200` - added the new `DELAYED_PAYMENT` enum value to the `price/commission/amount/otherCoinage/items/coinageCode` response property for the response status `200` - added the new `DELAYED_PAYMENT` enum value to the `price/roomFees/items/amount/otherCoinage/items/coinageCode` response property for the response status `200` - added the new `DELAYED_PAYMENT` enum value to the `price/tax/otherCoinage/items/coinageCode` response property for the response status `200` - …1 more - **2026-08-10** `34c735aa7110`: 1 info - added the optional property `price/taxBreakdown/items/description` to the response with the `200` status [Operation history](https://skmtc.dev/spotnana/apis/hotel-api/changes/v2/hotel/price-check/post.md) --- [API](https://skmtc.dev/spotnana/apis/hotel-api.md) - [All operations](https://skmtc.dev/spotnana/apis/hotel-api/llms.txt) - [OpenAPI document](https://skmtc.dev/spotnana/apis/hotel-api/revisions/bbaa6de99ce8?raw)