---
title: "Retrieve voucher usage history"
method: GET
path: "/vouchers/history"
tags: ["Vouchers"]
---

# Retrieve voucher usage history

`GET /vouchers/history`

## Overview

Get a complete history of all voucher redemptions across your system, showing which vouchers were used, when, and for which bookings.

## When to Use

- **Usage analytics** - Track voucher redemption patterns
- **Performance reporting** - See which vouchers are most popular
- **Audit trail** - Maintain records of voucher usage
- **Marketing insights** - Understand voucher effectiveness

## What You Get

- **Usage records** - Each voucher redemption with full details
- **Booking information** - Booking IDs and hotel or flight names where vouchers were used
- **Guest details** - Email addresses of guests who used vouchers
- **Discount amounts** - Total discount applied per usage
- **Timestamps** - When each voucher was redeemed

## Quick Start

No parameters required. Returns complete usage history for all vouchers across hotel and flight bookings, including booking details and discount amounts.

## Response `200`

Voucher updated successfully

- object
  - `history` object[] — List of voucher usage details.
    - `id` integer — Unique identifier for the voucher usage history entry.
    - `voucher_code` string — The code of the voucher used.
    - `guest_email` string — Email address of the guest who used the voucher.
    - `hotel_name` string — Name of the hotel or flight route where the voucher was used.
    - `booking_id` string — Unique identifier for the booking associated with the voucher.
    - `voucher_total_amount` number — Total amount of the voucher used.
    - `usage_date` string, date-time — Date and time when the voucher was used.

---

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