---
title: "Redeem a guest's loyalty points"
method: POST
path: "/guests/{guestId}/loyalty-points/redeem"
tags: ["Loyalty Program"]
---

# Redeem a guest's loyalty points

`POST /guests/{guestId}/loyalty-points/redeem`

## Overview

Convert a guest's loyalty points into a discount voucher. Points are converted at a rate of **10 points = $1 USD** (or equivalent in the specified currency).

## When to Use

- **Points redemption** - Allow guests to convert points to vouchers
- **Reward fulfillment** - Create discount vouchers from points
- **Loyalty rewards** - Enable points-to-cash conversion

## What You Get

- **Voucher code** - Unique code the guest can use for discounts
- **Voucher details** - Discount type, value, validity period, and usage limits
- **Fixed amount voucher** - Voucher with a specific discount value
- **Shareable voucher** - Can be used by other guests

## Key Features

- **Conversion rate** - 10 points = $1 USD (or equivalent)
- **Currency support** - Specify the currency for the voucher value
- **Shareable** - Vouchers can be shared with other guests
- **Fixed amount** - Creates a fixed discount amount voucher

## Quick Start

Provide the guest ID and specify `points` (amount to redeem) and `currency` (e.g., "USD"). Returns a voucher code and details.

## Path parameters

- `guestId` integer, required

## Request body

- object
  - `points` integer, required — Amount of points to redeem. 10 points = $1 USD.
  - `currency` string, required — Currency in which the voucher value will be calculated.

## Response `200`

OK

- object
  - `data` object
    - `voucherCode` string
    - `userID` integer
    - `guestID` integer
    - `discountType` string
    - `discountValue` number
    - `minimumSpend` number
    - `maximumDiscountAmount` number
    - `currency` string
    - `validityStart` string, date
    - `validityEnd` string, date
    - `usages` integer
    - `usagesLimit` integer
    - `status` string
    - `termsAndConditions` string
    - `category` string
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
    - `deletedAt` string, date-time

## Other responses

- `400` — Bad Request

---

[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)