---
title: "Get hotel ancillaries"
method: POST
path: "/v2/hotel/ancillaries"
tags: ["Hotel"]
---

# Get hotel ancillaries

`POST /v2/hotel/ancillaries`

## Request

- Base URL: `https://api-ext-sboxmeta.partners.spotnana.com`
- URL: `https://api-ext-sboxmeta.partners.spotnana.com/v2/hotel/ancillaries`
- Auth: HTTP bearer

Retrieves available ancillaries (add-ons, extras, services) for a selected hotel booking. Ancillaries may include breakfast, parking, early check-in, late checkout, spa services, and other optional services.

## Request body

- HotelAncillariesRequest: Request to retrieve available ancillaries for a hotel booking.
  - `priceValidateKey` string, required: The unique price validate key for the selected hotel rate.

## Response `200`

OK

- HotelAncillariesResponse: Response containing available ancillaries for the hotel booking.
  - `ancillaries` HotelAncillary[]: List of available ancillaries for the selected hotel booking.
    - `ancillaryKey` string, required: Unique identifier for the ancillary service.
    - `category` 'ANCILLARY_UNKNOWN' | 'EARLY_CHECKIN' | 'LATE_CHECKOUT' | 'WIFI' | 'BREAKFAST' | 'PARKING' | 'PETS' | 'MEAL_PLAN' | 'OTHER', required: Type of ancillary.
    - `displayName` string, required: Display name of ancillary.
    - `description` string: Detailed description of ancillary.
    - `dailyPrice` 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.
              - …
    - `totalPrice` 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.
              - …
    - `refundability` 'REFUNDABILITY_UNKNOWN' | 'FULLY_REFUNDABLE' | 'PARTIALLY_REFUNDABLE' | 'NON_REFUNDABLE', required: Refundability information about the ancillary.
    - `purchaseStatus` 'PURCHASE_STATUS_UNKNOWN' | 'AVAILABLE' | 'ALREADY_PURCHASED' | 'INCLUDED_IN_RATE', required: Purchase status of the ancillary.
    - `paymentType` 'PAYMENT_TYPE_UNKNOWN' | 'PREPAID' | 'POSTPAID', required: Payment type for the ancillary.
    - `totalRate` HotelRoomRate: 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.
              - …
      - `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.
              - …
      - `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.
              - …
        - `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.
              - …
        - `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.
              - …
        - `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
    - `prepaidRate` HotelRoomRate: 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.
              - …
      - `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.
              - …
      - `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.
              - …
        - `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.
              - …
        - `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.
              - …
        - `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
    - `postpaidRate` HotelRoomRate: 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.
              - …
      - `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.
              - …
      - `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.
              - …
        - `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.
              - …
        - `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.
              - …
        - `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
    - `status` 'ANCILLARY_STATUS_UNKNOWN' | 'ACTIVE' | 'CANCELLED' | 'MODIFIED': Status of the ancillary service.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: The specified resource was not found.

## Changes

- **2026-10-29** `65c527a9a98d`: 17 warning
  - added the new `DELAYED_PAYMENT` enum value to the `ancillaries/items/dailyPrice/otherCoinage/items/coinageCode` response property for the response status `200`
  - added the new `DELAYED_PAYMENT` enum value to the `ancillaries/items/postpaidRate/base/otherCoinage/items/coinageCode` response property for the response status `200`
  - added the new `DELAYED_PAYMENT` enum value to the `ancillaries/items/postpaidRate/commission/amount/otherCoinage/items/coinageCode` response property for the response status `200`
  - added the new `DELAYED_PAYMENT` enum value to the `ancillaries/items/postpaidRate/roomFees/items/amount/otherCoinage/items/coinageCode` response property for the response status `200`
  - …13 more
- **2026-08-10** `34c735aa7110`: 3 info
  - added the optional property `ancillaries/items/postpaidRate/taxBreakdown/items/description` to the response with the `200` status
  - added the optional property `ancillaries/items/prepaidRate/taxBreakdown/items/description` to the response with the `200` status
  - added the optional property `ancillaries/items/totalRate/taxBreakdown/items/description` to the response with the `200` status

[Operation history](https://skmtc.dev/spotnana/apis/hotel-api/changes/v2/hotel/ancillaries/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)
