---
title: "Fetch a guest's vouchers"
method: GET
path: "/guests/{guestId}/vouchers"
tags: ["Loyalty Program"]
---

# Fetch a guest's vouchers

`GET /guests/{guestId}/vouchers`

## Overview

Retrieve all vouchers available to a specific guest, including discount codes, validity periods, and usage limits.

## When to Use

- **Voucher display** - Show available vouchers on a guest's account page
- **Discount management** - Check which vouchers a guest can use
- **Validity checking** - Verify if vouchers are still active
- **Usage tracking** - Monitor voucher usage counts

## What You Get

- **Voucher list** - All vouchers assigned to the guest
- **Discount details** - Type (percentage/fixed), value, and currency
- **Validity period** - Start and end dates for each voucher
- **Usage information** - Current usage count and usage limits
- **Status** - Active/inactive status of each voucher

## Quick Start

Provide the guest ID in the URL path. Returns all vouchers available to that guest.

## Path parameters

- `guestId` integer, required

## Response `200`

List of vouchers

- object
  - `data` object[]
    - `id` integer
    - `voucher_code` string
    - `user_id` integer
    - `guest_id` integer
    - `discount_type` string
    - `discount_value` number
    - `minimum_spend` number
    - `maximum_discount_amount` number
    - `currency` string
    - `validity_start` string, date-time
    - `validity_end` string, date-time
    - `usages` integer
    - `usages_limit` integer
    - `status` string
    - `terms_and_conditions` string
    - `category` string
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `deleted_at` 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)