---
title: "Create a new voucher"
method: POST
path: "/vouchers"
tags: ["Vouchers"]
---

# Create a new voucher

`POST /vouchers`

## Overview

Create discount vouchers that customers can apply to their hotel and flight bookings. Supports percentage discounts, fixed amounts, and points redemption vouchers.

## When to Use

- **Promotional campaigns** - Create discount codes for marketing
- **Customer rewards** - Generate vouchers for loyal customers
- **Special offers** - Create time-limited discount vouchers
- **Points redemption** - Generate vouchers from loyalty points

## What You Get

- **Voucher object** - Complete voucher details including code and settings
- **Usage tracking** - Remaining uses count
- **Validation** - Confirmation that the voucher was created successfully

## Key Features

- **Multiple discount types** - Percentage, fixed amount, or points redemption
- **Flexible rules** - Set minimum spend, maximum discount, and usage limits
- **Validity control** - Define start and end dates
- **Guest assignment** - Optionally assign to specific guests
- **Applies to hotels and flights** - Pass the `voucherCode` in the `voucherCode` field of `/rates/prebook` (hotels) or `/flights/prebooks` (flights) to redeem the discount at checkout

## Quick Start

Provide voucher code, discount type, value, currency, validity dates, usage limits, and status. Returns the created voucher with all details.

## Request body

- object
  - `voucher_code` string, required — A unique code for the new voucher. e.g. manhattan-holidays-100
  - `discount_type` string, required — Type of discount, such as percentage, or points_redemption
  - `discount_value` number, required — Value of the discount applied by the voucher. For percentage discounts, a value of 10 represents a 10% discount. For points_redemption, it indicates the fixed amount of points to be redeemed e.g. 10 equals 10 points
  - `minimum_spend` number, required — Minimum rate to apply the discount voucher in the voucher currency. e.g. a minimum_spend of USD$100 will only apply for bookings with a price USD$100 or more
  - `maximum_discount_amount` number, required — Maximum discount amount that can be applied using the voucher in voucher currency. e.g. a with a maximum_discount_amount of 50 in USD, will discount from 0 to USD$50
  - `currency` string, required — Currency in which the discount is offered
  - `validity_start` string, date, required — Date from which the voucher becomes valid
  - `validity_end` string, date, required — Date until which the voucher remains valid
  - `usages_limit` number, required — Maximum number of times the voucher can be redeemed
  - `status` string, required — Current status of the voucher (e.g., active, inactive)
  - `guest_id` string — The unique identifier of the guest associated with the voucher
  - `description` string — A brief description of the voucher, detailing its purpose or offer
  - `terms_and_conditions` string — Terms and conditions associated with the voucher
  - `budget` number — Total monetary pool the voucher can distribute across all redemptions, in the voucher's currency. If not set or 0, there is no monetary limit and usage is only controlled by usages_limit. When set, budget and usages_limit act as independent limits — whichever is exhausted first will reject the voucher.

## Response `201`

Voucher created successfully

- object
  - `voucher` object
    - `id` integer — Unique identifier for the voucher
    - `voucher_code` string — A unique code for the new voucher. e.g. manhattan-holidays-100
    - `discount_type` string — Type of discount, such as percentage or fixed_amount
    - `discount_value` number — Represents the discount amount. For percentage discounts, it indicates the percentage (e.g., 10 for 10%). For fixed amount discounts, it represents the fixed amount in the specified currency (e.g., 10 represents US$10 or €10)
    - `minimum_spend` number — Minimum rate to apply the discount voucher in the voucher currency. e.g. a minimum_spend of USD$100 will only apply for bookings with a price USD$100 or more
    - `maximum_discount_amount` number — Maximum discount amount that can be applied using the voucher in voucher currency. e.g. a with a maximum_discount_amount of 50 in USD, will discount from 0 to USD$50
    - `currency` string — Currency in which the discount is offered
    - `validity_start` string, date — Date from which the voucher becomes valid
    - `validity_end` string, date — Date until which the voucher remains valid
    - `usages_limit` number — Maximum number of times the voucher can be redeemed
    - `status` string — Current status of the voucher (e.g., active, inactive)
    - `created_at` string, date-time — Timestamp when the voucher was created
    - `updated_at` string, date-time — Timestamp when the voucher was last updated
    - `deleted_at` string, date-time, nullable — Timestamp when the voucher was deleted, if applicable
    - `user_id` integer — ID of the user associated with the voucher, if applicable
    - `remaining_uses` number — Number of times the voucher can still be redeemed
    - `guest_id` string — The unique identifier of the guest associated with the voucher
    - `description` string — A brief description of the voucher, detailing its purpose or offer
    - `terms_and_conditions` string — Terms and conditions associated with the voucher
    - `budget` number — Total monetary pool the voucher can distribute across all redemptions, in the voucher's currency. If not set or 0, there is no monetary limit and usage is only controlled by usages_limit. When set, budget and usages_limit act as independent limits — whichever is exhausted first will reject the voucher.
    - `budget_used` number — Sum of all discount amounts applied from this voucher across non-cancelled bookings. Computed field.

---

[API](https://skmtc.net/liteapi/apis/api-search.md) · [All operations](https://skmtc.net/liteapi/apis/api-search/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/liteapi/api-search/versions/315ba2a4dcf4/schema)