HotelProduct_HotelPrice

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-schema/hotel-search-hotel-product-hotel-price-schema.json",
  "title": "HotelProduct_HotelPrice",
  "description": "price information",
  "type": "object",
  "properties": {
    "currency": {
      "description": "currency Code apply to all elements of the price",
      "type": "string",
      "example": "EUR"
    },
    "sellingTotal": {
      "description": "sellingTotal = Total + margins + markup + totalFees - discounts",
      "type": "string",
      "example": "199.50"
    },
    "total": {
      "description": "total = base + totalTaxes",
      "type": "string",
      "example": "199.50"
    },
    "base": {
      "type": "string",
      "example": "string-value"
    },
    "taxes": {
      "type": "array",
      "items": {
        "title": "Tax",
        "description": "IATA Tax definition: An impost for raising revenue for the general treasury and which will be used for general public purposes.",
        "type": "object",
        "properties": {
          "amount": {
            "description": "Defines amount with decimal separator.",
            "type": "string",
            "example": "199.50"
          },
          "currency": {
            "description": "Defines a monetary unit. It is a three alpha code (iata code). Example: EUR for Euros, USD for US dollar, etc.",
            "type": "string",
            "minLength": 1,
            "maxLength": 3,
            "example": "EUR"
          },
          "code": {
            "description": "International Standards Organization (ISO) Tax code.It is a two-letter country code.",
            "type": "string",
            "example": "string-value"
          },
          "percentage": {
            "description": "In the case of a tax on TST value, the percentage of the tax will be indicated in this field.",
            "type": "string",
            "example": 50
          },
          "included": {
            "description": "Indicates if tax is included or not",
            "type": "boolean",
            "example": true
          },
          "description": {
            "description": "Example - \"Governement tax\"",
            "type": "string",
            "example": "Sample description text."
          },
          "pricingFrequency": {
            "description": "Specifies if the tax applies per stay or per night\n  - PER_STAY\n  - PER_NIGHT",
            "type": "string",
            "example": "string-value"
          },
          "pricingMode": {
            "description": "Specifies if the tax applies per occupant or per room\n  - PER_OCCUPANT\n  - PER_PRODUCT",
            "type": "string",
            "example": "string-value"
          }
        }
      }
    },
    "markups": {
      "type": "array",
      "items": {
        "title": "Markup",
        "description": "Markup applied to provide a service or a product to the client. The markup can be introduced by any stakeholder. Typical use case is to convey markup information set by the travel agent or in case of merchant mode.",
        "type": "object",
        "properties": {
          "amount": {
            "description": "Defines the monetary value with decimal position as a String.",
            "example": "10",
            "type": "string"
          }
        }
      }
    },
    "variations": {
      "title": "HotelProduct_PriceVariations",
      "description": "Daily price variations and the average daily price (when available) is shown here",
      "type": "object",
      "properties": {
        "average": {
          "title": "Price",
          "description": "Price valuation information",
          "type": "object",
          "properties": {
            "currency": {
              "description": "currency Code apply to all elements of the price",
              "type": "string",
              "example": "EUR"
            },
            "sellingTotal": {
              "description": "sellingTotal = Total + margins + markup + totalFees - discounts",
              "type": "string",
              "example": "199.50"
            },
            "total": {
              "description": "total = base + totalTaxes",
              "type": "string",
              "example": "199.50"
            },
            "base": {
              "type": "string",
              "example": "string-value"
            },
            "markups": {
              "type": "array",
              "items": {
                "$ref": "#/definitions/Markup"
              }
            }
          }
        },
        "changes": {
          "description": "A collection of price periods if the daily price changes during the stay",
          "type": "array",
          "items": {
            "$ref": "#/definitions/HotelProduct_PriceVariation"
          }
        }
      }
    }
  }
}