---
title: "List the issuer's own vouchers"
method: GET
path: "/vouchers/v1"
tags: ["Vouchers"]
---

# List the issuer's own vouchers

`GET /vouchers/v1`

## Request

- Base URL: `https://api.run402.com`
- URL: `https://api.run402.com/vouchers/v1`
- Auth: API key in header `x-run402-issuer-key`

Keyset-paginated list of vouchers minted by the calling issuer, newest first, including redemption status and the redeeming organization. Raw codes are never returned (only hashes are stored). Scoped strictly to the calling issuer.

## Query parameters

- `cursor` string
- `limit` integer

## Response `200`

Voucher page

- object
  - `vouchers` object[]
    - `voucher_id` string, uuid
    - `ref` string, nullable
    - `amount_usd_micros` integer
    - `expires_at` string, date-time
    - `created_at` string, date-time
    - `redeemed_at` string, date-time, nullable
    - `redeemed_by_org` string, uuid, nullable
  - `has_more` boolean
  - `next_cursor` string, nullable

## Other responses

- `400`: Invalid limit
- `401`: Missing or unknown issuer key

---

[API](https://skmtc.dev/run402/apis/run402-api.md) · [All operations](https://skmtc.dev/run402/apis/run402-api/llms.txt) · [OpenAPI document](https://skmtc.dev/run402/apis/run402-api/revisions/893607557f50?raw)