---
title: "List vouchers"
method: GET
path: "/organizations/{organization_id}/vouchers"
tags: ["Vouchers"]
---

# List vouchers

`GET /organizations/{organization_id}/vouchers`

Retrieves vouchers for the specified organization.

## Path parameters

- `organization_id` string, required

## Response `200`

OK

- Vouchers
  - `uuid` string, uuid — The uuid of the user.
  - `vouchers_total` string — The total voucher credit given to the user.
  - `vouchers_applied` string — The part of total voucher credit applied to orders.
  - `vouchers_remaining_balance` string — The remaining voucher credit, available for future orders.
  - `currency` string — The currency of the vouchers.
  - `vouchers` object[] — Array of vouchers.
    - `code` string — The voucher code.
    - `amount` string — The total voucher credit.
    - `currency` string — The currency of the voucher.
    - `orders` object[] — Array of orders to which a voucher applied.
      - `order_id` string — The id of the order.
      - `status` string — The status of the order.
      - `billing_period_start` string — The billing period start timestamp of the order (ISO 8601).
      - `billing_period_end` string — The billing period end timestamp of the order (ISO 8601).
      - `order_total` string — The total of the order.
      - `order_discount` string — The total voucher credit applied to the order.
      - `currency` string — The currency of the order.
  - `_links` object
    - `self` object — Link to the current resource.
      - `href` string — URL of the link.

## Other responses

- `403` — Forbidden
- `404` — Not Found

---

[API](https://skmtc.net/upsun/apis/upsun-com-rest-api.md) · [All operations](https://skmtc.net/upsun/apis/upsun-com-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/upsun/upsun-com-rest-api/revisions/6cc88fde6435/schema)