---
title: "Retrieve all vouchers"
method: GET
path: "/vouchers"
tags: ["Vouchers"]
---

# Retrieve all vouchers

`GET /vouchers`

## Overview

Get a paginated list of all vouchers in your system, including active and inactive vouchers with their current status.

## When to Use

- **Voucher management** - View all vouchers in your admin panel
- **Inventory overview** - See all available discount codes
- **Status monitoring** - Check which vouchers are active
- **Reporting** - Generate lists of all vouchers for analysis

## What You Get

- **Complete voucher list** - All vouchers with full details
- **Discount information** - Type, value, and currency for each voucher
- **Validity status** - Start/end dates and current status
- **Usage tracking** - Remaining uses for each voucher

## Pagination

Results are paginated. Use the `page` and `limit` query parameters to navigate through the list, e.g. `/vouchers?page=5&limit=10`.

## Quick Start

Optionally provide `page` and `limit` query parameters. Returns a paginated list of vouchers with complete details including codes, discounts, validity, and usage counts.

## Query parameters

- `page` integer
- `limit` integer

## Response `200`

A paginated list of vouchers with their details

- 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, e.g., percentage or fixed amount
    - `discount_value` number — Value of the discount applied by the voucher
    - `minimum_spend` number — Minimum spending required to apply 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 — Start date from when the voucher is valid
    - `validity_end` string, date — End date after which the voucher is no longer valid
    - `usages_limit` number — Maximum number of times the voucher can be used
    - `status` string — Current status of the voucher (e.g., active, inactive, expired)
    - `created_at` string, date-time — Timestamp when the voucher was created
    - `updated_at` string, date-time — Timestamp when the voucher was last updated
    - `deleted_at` string, date-time, nullable — Timestamp 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.

---

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