---
title: "Add coupons to an existing quote"
method: POST
path: "/quotes/{quoteId}/coupons"
tags: ["Quotes Open Api [Beta]"]
---

# Add coupons to an existing quote

`POST /quotes/{quoteId}/coupons`

Add coupons to an existing quote

## Path parameters

- `quoteId` string, required

## Query parameters

- `mergeAccommodationFarePriceComponents` boolean

## Request body

- object
  - `coupons` string[], required — List of coupons

## Response `200`

The coupons had been successfuly added to the quote

- object
  - `_id` string, required
  - `accountId` string, required
  - `reservationId` string
  - `status` 'valid', required
  - `guestsCount` number, required
  - `channel` 'manual_reservations' | 'owner_reservations' | 'booking_engine', required
  - `source` string, required
  - `stay` object[]
    - `numberOfGuests` object — Object. Contains the breakdown of the guests
      - `numberOfChildren` number — Number of children
      - `numberOfInfants` number — Number of infants
      - `numberOfPets` number — Number of pets
      - `numberOfAdults` number, required — Number of adults
    - `_id` object
    - `checkInDateLocalized` string, required
    - `checkOutDateLocalized` string, required
    - `guestsCount` number, required
    - `unitTypeId` object, required
    - `unitId` object
    - `ratePlanId` string
    - `eta` string, date-time, required
    - `etd` string, date-time, required
    - `earlyCheckIn` object
    - `lateCheckOut` object
  - `createdAt` string, date-time, required
  - `expiresAt` string, date-time, required
  - `unitTypeId` string, required
  - `unitId` string
  - `unassign` boolean
  - `checkInDateLocalized` string, required
  - `checkOutDateLocalized` string, required
  - `rates` object, required
  - `bookerId` string
  - `coupons` object[], required
  - `promotions` object, required
  - `alterationPayload` object
    - `dates` object
      - `checkInDateLocalized` string, required
      - `checkOutDateLocalized` string, required
    - `unit` object
      - `unitId` string
      - `unitTypeId` string, required
      - `unassign` boolean
    - `guestsCount` number
    - `ratePlanId` string
    - `reservationId` string, required
    - `status` 'confirmed' | 'reserved' | 'awaiting_payment' | 'inquiry' | 'canceled' | 'closed' | 'declined' | 'expired'
    - `numberOfGuests` object
      - `numberOfChildren` number
      - `numberOfInfants` number
      - `numberOfAdults` number, required
  - `numberOfGuests` object
    - `numberOfChildren` number — Number of children
    - `numberOfInfants` number — Number of infants
    - `numberOfPets` number — Number of pets
    - `numberOfAdults` number, required — Number of adults
  - `pointOfSale` string

## Other responses

- `400` — Provided coupons are invalid

---

[API](https://skmtc.net/guesty/apis/guesty-open-api.md) · [All operations](https://skmtc.net/guesty/apis/guesty-open-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/guesty/guesty-open-api/versions/7c62644070f2/schema)