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

# Retrieve voucher usage history

`GET /vouchers/history`

## Request

- Base URL: `https://da.liteapi.travel`
- URL: `https://da.liteapi.travel/vouchers/history`
- Auth: API key in header `X-Api-Key`

## 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.dev/liteapi/apis/api-vouchers.md) - [All operations](https://skmtc.dev/liteapi/apis/api-vouchers/llms.txt) - [OpenAPI document](https://skmtc.dev/liteapi/apis/api-vouchers/revisions/531116f98f62?raw)