---
title: "Update coupon in a quote"
method: POST
path: "/api/reservations/quotes/{quoteId}/coupons"
tags: ["Reservation quote"]
---

# Update coupon in a quote

`POST /api/reservations/quotes/{quoteId}/coupons`

Ability to add/remove a coupon from existing quote.

## Path parameters

- `quoteId` string, required

## Request body

- object
  - `coupons` string[] — it will set quote coupons to coupon-1 and coupon-2 and if the quote had another ones the request will remove them

## Response `201`

successful operation

- object
  - `_id` string, required — This is a quote id for creating instant/inquiry reservation
  - `createdAt` string, date-time, required — The quote was created at
  - `expiresAt` string, date-time, required — The quote will be expired at
  - `promotions` object, required
    - `name` string
    - `type` string
    - `description` string
    - `adjustment` integer
  - `coupons` object[], required — List of coupons applied for the reservation quote
    - `name` string
    - `type` 'percentage'
    - `code` string
    - `adjustment` integer
  - `rates` object, required
    - `ratePlans` object[]
      - `ratePlan` object
        - `_id` string
        - `name` string
        - `type` string
        - `mealPlans` string[]
        - `cancellationPolicy` string[]
        - `cancellationFee` string
        - `priceAdjustment` object
          - `type` string
          - `direction` string
          - `amount` number
        - `days` object[]
          - `date` string, date
          - `price` integer
          - `currency` string
          - `basePrice` integer
          - `rateStrategy` integer
          - `ratePlan` integer
          - `lengthOfStay` integer
        - `money` object
          - `invoiceItems` object[]
            - `title` string
            - `amount` number
            - `currency` 'USD' | 'EUR' | 'AUD' | 'CAD' | 'JPY' | 'ILS' | 'GBP' | 'HKD' | 'NOK' | 'CZK' | 'BRL' | 'CHF' | 'THB' | 'ZAR' | 'MYR' | 'KRW' | 'IDR' | 'PHP' | 'INR' | 'NZD' | 'TWD' | 'PLN' | 'SGD' | 'TRY' | 'SEK' | 'VND' | 'ARS' | 'CNY' | 'DKK' | 'MXN'
            - `type` string
            - `normalType` string
            - `description` string
            - `includedTaxesList` object[] — List of taxes included in this invoice item. This field shows the included taxes that apply on the invoice item and is relevant only for users with inclusive taxes enabled.
              - …
          - `_id` string
          - `fareAccommodationAdjusted` number
          - `currency` 'USD' | 'EUR' | 'AUD' | 'CAD' | 'JPY' | 'ILS' | 'GBP' | 'HKD' | 'NOK' | 'CZK' | 'BRL' | 'CHF' | 'THB' | 'ZAR' | 'MYR' | 'KRW' | 'IDR' | 'PHP' | 'INR' | 'NZD' | 'TWD' | 'PLN' | 'SGD' | 'TRY' | 'SEK' | 'VND' | 'ARS' | 'CNY' | 'DKK' | 'MXN'
          - `fareAccommodation` number
          - `fareCleaning` number
          - `totalFees` number
          - `subTotalPrice` number
          - `hostPayout` number
          - `hostPayoutUsd` number
          - `totalTaxes` number
      - `inquiryId` string — Per-rate-plan financial quote identifier. Use this value as the inquiryId path parameter in the Retrieve Upsell endpoint.
  - `guestId` string

## Other responses

- `400` — Bad request
- `401` — Not authorized
- `403` — Forbidden
- `429` — Too many requests

---

[API](https://skmtc.dev/guesty/apis/booking-engine-api.md) · [All operations](https://skmtc.dev/guesty/apis/booking-engine-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/guesty/booking-engine-api/revisions/90f25f70255b/schema)