action viator_booking_status_items {
  label: "/booking/status/items"
  description: "Get brief booking statuses\n\nThis service is similar to [/booking/status](#operation/bookingStatus) in that it:\n- retrieves the booking status for multiple items based on different criteria\n- has the same request parameters as [/booking/status](#operation/bookingStatus)\n\nHowever, it differs in that it returns a multi-item array of booking items with less detail than what would be received from [/booking/status](#operation/bookingStatus).\n"
  provider: viator
  method: POST
  path: "/booking/status/items"
  encoding: json
  input: {
    type: "object"
    description: "**note**: all items are optional, but at least one needs to be included"
    properties: {
      bookingDateFrom: {
        type: "string"
        description: "**earliest date** for when the booking(s) in question were made (must be in the future)"
      }
      bookingDateTo: {
        type: "string"
        description: "**latest date** for when the booking(s) in question were made (must be in the future)"
      }
      distributorItemRefs: {
        type: "array"
        description: "**array** of partner-defined distributor item reference identifiers e.g. `['refItem1','refItem2','refItem3']`"
        items: {
          type: "string"
        }
      }
      distributorRefs: {
        type: "array"
        description: "**array** of partner-defined distributor reference identifiers"
        items: {
          type: "string"
        }
      }
      itemIds: {
        type: "array"
        description: "**array** of booking-reference numbers to check\n\n `itemId` (booking-reference provided by Viator). For more information, see [Booking references](#section/Key-concepts/Booking-references)\n"
        items: {
          type: "integer"
          description: "**numeric item identifier**"
        }
      }
      leadFirstName: {
        type: "string"
        description: "**first name** of the lead traveler"
      }
      leadSurname: {
        type: "string"
        description: "**surname** of the lead traveler"
      }
      test: {
        type: "boolean"
        description: "**specifier**:\n- `true`: bypass the poll limit in the prelive environment only\n- `false`: (default) make a *real* booking, not a test\n"
      }
    }
  }
  output: {
    type: "object"
  }
}