action viator_cancel_booking_quote {
  label: "/bookings/{booking-reference}/cancel-quote"
  description: "Retrieves a quote for the cancellation of a booking\n\nFor information on how to use this service, see: [Cancellation API workflow](#section/Common-workflows-and-data-validation/Cancellation-API-workflow)\n\n**Note**: \n\n  * This service <u>requires</u> [exp-api-key](#section/Authentication/exp-api-key) to be included as a header parameter. Please speak to your account manager if you have not yet been issued an exp-api-key.\n  * The base URL for the server for this endpoint is different from the older endpoints described in this document. Use `https://api.sandbox.viator.com/partner/bookings/{booking-reference}/cancel-quote`\n"
  provider: viator
  method: GET
  path: "/bookings/{booking-reference}/cancel-quote"
  encoding: json
  input: {
    type: "object"
    properties: {
      "booking-reference": {
        type: "string"
      }
    }
    required: ["booking-reference"]
    additionalProperties: false
  }
  output: {
    type: "object"
    properties: {
      bookingId: {
        type: "string"
        description: "The booking reference number, prepended with `BR-`"
      }
      refundDetails: {
        type: "object"
        description: "Details of the refund\n\n**Note**: Bookings that have not been confirmed by the supplier and have a status of `\"PENDING\"` will report an `itemPrice`, `refundAmount` and `refundPercentage` of `0`, as no fees are charged until the booking has been accepted by the supplier and its status is `\"CONFIRMED\"`.\n"
        properties: {
          currencyCode: {
            type: "string"
            description: "Three-letter code indicating the currency in which `itemPrice` and `refundAmount` are displayed"
          }
          itemPrice: {
            type: "number"
            description: "The merchant net price at the time this product was booked"
          }
          refundAmount: {
            type: "number"
            description: "Numeric currency amount that will be refunded if this booking is cancelled now"
          }
          refundPercentage: {
            type: "number"
            description: "Percentage of the item price that will be refunded if this booking is cancelled now"
          }
        }
      }
      status: {
        type: "string"
        description: "String indicating the cancellation status of this itinerary item:\n\n  * `CANCELLABLE` - this booking is available to be cancelled\n  * `CANCELLED` - this booking has already been cancelled\n  * `NOT_CANCELLABLE` - this booking cannot be cancelled (because the product's operation date is now in the past)\n"
        enum: ["CANCELLABLE", "CANCELLED", "NOT_CANCELLABLE"]
      }
    }
  }
}