Skip to main content
POST
/
vouchers
Create a new voucher
curl --request POST \
  --url https://da.liteapi.travel/vouchers \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "id": 120,
  "voucher_code": "HELLOHOLIDAYS",
  "discount_type": "percentage",
  "discount_value": 30,
  "minimum_spend": 60,
  "maximum_discount_amount": 20,
  "currency": "USD",
  "validity_start": "2026-07-03",
  "validity_end": "2026-07-30",
  "usages_limit": 10,
  "status": "active",
  "created_at": "2026-07-10T09:41:43.000Z",
  "updated_at": "2026-07-10T09:41:43.000Z",
  "deleted_at": null,
  "user_id": 961,
  "terms_and_conditions": null,
  "remaining_uses": 10,
  "guest_id": 394,
  "description": "Holiday season voucher"
}
'
{
  "voucher": [
    {
      "id": 120,
      "voucher_code": "HELLOHOLIDAYS",
      "discount_type": "percentage",
      "discount_value": 30,
      "minimum_spend": 60,
      "maximum_discount_amount": 20,
      "currency": "USD",
      "validity_start": "2026-07-03",
      "validity_end": "2026-07-30",
      "usages_limit": 10,
      "status": "active",
      "created_at": "2026-07-10T09:41:43.000Z",
      "updated_at": "2026-07-10T09:41:43.000Z",
      "deleted_at": null,
      "user_id": 961,
      "terms_and_conditions": null,
      "remaining_uses": 10,
      "guest_id": 394,
      "description": "Holiday season voucher"
    }
  ]
}

Authorizations

​
X-Api-Key
string
header
required

API key required for authorization

Body

application/json
​
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

Response

201 - application/json

Voucher created successfully

​
voucher
object