Amadeus · Schema

Tax

IATA Tax definition: An impost for raising revenue for the general treasury and which will be used for general public purposes.

TravelTravel TechnologyReservationsFlightsHotelsAirlinesHospitalityTours and ActivitiesCars and TransfersDestination ContentItinerary ManagementTrip PlanningArtificial IntelligenceMarket Insights

Properties

Name Type Description
amount string Defines amount with decimal separator.
currency string Defines a monetary unit. It is a three alpha code (iata code). Example: EUR for Euros, USD for US dollar, etc.
code string International Standards Organization (ISO) Tax code.It is a two-letter country code.
percentage string In the case of a tax on TST value, the percentage of the tax will be indicated in this field.
included boolean Indicates if tax is included or not
description string Example - "Governement tax"
pricingFrequency string Specifies if the tax applies per stay or per night - PER_STAY - PER_NIGHT
pricingMode string Specifies if the tax applies per occupant or per room - PER_OCCUPANT - PER_PRODUCT
View JSON Schema on GitHub

JSON Schema

hotel-search-tax-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-schema/hotel-search-tax-schema.json",
  "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"
    }
  }
}