action viator_booking_status {
  label: "/booking/status"
  description: "Get the booking status for multiple items based on different criteria\n\nThis service: \n- is ideally be used in software for bulk updates of pending bookings\n- returns a maximum of 1000 bookings (narrow your search if you expect a greater number of results)\n- will return <u>both</u> live <u>and</u> test bookings\n- rate limited to <u>one request every 30 minutes</u>\n- For more information, see: [Get the bookiing status for multiple items](#section/Common-workflows-and-data-validation/Get-the-booking-status-for-multiple-items)\n\n**Exceeding the rate limit**\n- You will receive the following error message if you exceed the rate limit allowed for this service. Set `test` to `true` to bypass this limit:\n```javascript\n{\n    \"data\": null\n    \"vmid\": 221002\n    \"errorMessage\": [\"Access allowed every 30 minutes\"]\n    \"errorType\": \"EXCEPTION\"\n    \"dateStamp\": \"2013-03-26T10:28:51+0000\"\n    \"errorReference\": 55315512721712161381352771\n    \"errorMessageText\": [\"Access allowed every 30 minutes\"]\n    \"success\": false\n    \"totalCount\": 1\n    \"errorName\": \"PollingDeniedException\"  \n}\n```\n"
  provider: viator
  method: POST
  path: "/booking/status"
  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 *this* booking (must be in the future)"
      }
      bookingDateTo: {
        type: "string"
        description: "**latest date** for *this* booking (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 item identifiers to check"
        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 (recommended for testing)\n- `false`: (default)\n"
      }
    }
  }
  output: {
    type: "object"
  }
}