action viator_booking_availability {
  label: "/booking/availability"
  description: "Get the tour-grade with the lowest price that is available for a product on each day of the specified month\n\nThis service:\n- returns \n- useful when displaying a calendar of available tours\n- For more information, see: [Availability services](#section/Key-concepts/Availability-services)\n- **Notes:** \n  - [/booking/availability/dates](#operation/bookingAvailabilityDates) provides all availability in one call and is more suitable for calendars, etc.\n\n  - Availability data is limited to a period of **12 months** into the future from the present time on the production server and **6 months** on the sandbox server. \n"
  provider: viator
  method: POST
  path: "/booking/availability"
  encoding: json
  input: {
    type: "object"
    properties: {
      ageBands: {
        type: "array"
        description: "**array of objects** specifying the age bands by which to to filter search results"
        items: {
          type: "object"
          properties: {
            bandId: {
              type: "integer"
              description: "**unique numeric identifier** for the age band\n- See: [Working with age bands](#section/Appendices/Working-with-age-bands)\n"
            }
            count: {
              type: "integer"
              description: "**number of people** in *this* age band"
            }
          }
        }
      }
      currencyCode: {
        type: "string"
        description: "**currency code** for the currency in which to display tour grade pricing information"
      }
      month: {
        type: "string"
        description: "**month component** (text format) of the start of the date range for which to retrieve tour grade availability information (must be in the future)"
      }
      productCode: {
        type: "string"
        description: "**unique alphanumeric identifier** of the product for which you wish to retrieve tour grade availability information"
      }
      year: {
        type: "string"
        description: "**year component** (text format) of the start of the date range for which to retrieve tour grade availability information (must be in the future)"
      }
    }
  }
  output: {
    type: "object"
  }
}