---
title: "Retrieve a specific voucher"
method: GET
path: "/vouchers/{voucherID}"
tags: ["Vouchers"]
---

# Retrieve a specific voucher

`GET /vouchers/{voucherID}`

## Overview

Get complete details for a specific voucher by its ID, including discount rules, validity, and usage information.

## When to Use

- **Voucher lookup** - Find details for a specific voucher code
- **Validation** - Verify voucher details before applying to bookings
- **Details display** - Show voucher information to customers
- **Support** - Look up voucher information during customer service

## What You Get

- **Complete voucher details** - All information about the voucher
- **Discount rules** - Type, value, minimum spend, maximum discount
- **Validity information** - Start/end dates and current status
- **Usage data** - Current usage count and remaining uses

## Quick Start

Provide the voucher ID in the URL path. Returns complete voucher information.

## Path parameters

- `voucherID` integer, required

## Response `200`

Voucher details retrieved successfully

- object
  - `voucher` object
    - `id` integer — Unique identifier for the voucher
    - `voucher_code` string — Code used to redeem the voucher
    - `discount_type` string — Type of discount provided by the voucher
    - `discount_value` number — Value of the discount
    - `minimum_spend` number — Minimum amount required to use the voucher
    - `maximum_discount_amount` number — Maximum discount amount that can be applied
    - `currency` string — Currency in which the discount is applied
    - `validity_start` string, date — Date from which the voucher is valid
    - `validity_end` string, date — Date until which the voucher is valid
    - `usages_limit` number — Maximum number of times the voucher can be used
    - `status` string — Current status of the voucher (e.g., active, inactive)
    - `created_at` string, date-time — Date and time when the voucher was created
    - `updated_at` string, date-time — Date and time when the voucher was last updated
    - `deleted_at` string, date-time, nullable — Date and time when the voucher was deleted, if applicable
    - `user_id` integer — ID of the user associated with the voucher, if applicable
    - `terms_and_conditions` string — Terms and conditions associated with the voucher
    - `remaining_uses` number — Number of times the voucher can still be redeemed
    - `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
    - `budget` number — Total monetary pool the voucher can distribute across all redemptions, in the voucher's currency. If not set or 0, there is no monetary limit and usage is only controlled by usages_limit. When set, budget and usages_limit act as independent limits — whichever is exhausted first will reject the voucher.
    - `budget_used` number — Sum of all discount amounts applied from this voucher across non-cancelled bookings. Computed field.

## Other responses

- `400` — Voucher not found

---

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