---
title: "List vouchers"
method: GET
path: "/api/business/{businessId}/voucher"
tags: ["Voucher"]
---

# List vouchers

`GET /api/business/{businessId}/voucher`

Get a list of vouchers for the specified business id. List can be filtered by client id, serial number, DateTime of update and possibility to include used vouchers

## Path parameters

- `businessId` string, required

## Query parameters

- `clientId` string
- `serialNumber` string
- `includeUsed` boolean
- `updated_from` string
- `updated_to` string

## Response `200`

Vouchers listed

- DataPagedModelVoucherResponse
  - `_embedded` object
    - `vouchers` VoucherResponse[]
      - `serialNumber` string
      - `issueDate` string, date-time, required
      - `expiryDate` string, date-time, required
      - `clientId` string
      - `creatingBranchId` string, required
      - `originalBalance` number, required
      - `notes` string
      - `voucherId` string
      - `createdAt` string, date-time
      - `updatedAt` string, date-time
      - `remainingBalance` number
  - `page` PageMetadata
    - `size` integer
    - `totalElements` integer
    - `totalPages` integer
    - `number` integer

## Other responses

- `400` — Bad Request
- `404` — Business with the specified id doesn't exist
- `429` — Request rate limit exceeded. Current limit set to 100 rps.
- `500` — Internal Server Error

---

[API](https://skmtc.net/phorest/apis/third-party-api.md) · [All operations](https://skmtc.net/phorest/apis/third-party-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/phorest/third-party-api/revisions/2218bc90d39c/schema)