---
title: "Get purchases by voucher (with optional pagination). Roles: admin, group member."
method: GET
path: "/api/product-vouchers/{productVoucherId}/purchases"
tags: ["Purchases", "Product Vouchers"]
---

# Get purchases by voucher (with optional pagination). Roles: admin, group member.

`GET /api/product-vouchers/{productVoucherId}/purchases`

## Request

- Base URL: `https://api.mobilecoach.org` (the document declares no server; this is the origin it was published from)
- URL: `https://api.mobilecoach.org/api/product-vouchers/{productVoucherId}/purchases`
- Auth: none declared

## Path parameters

- `productVoucherId` integer, required

## Query parameters

- `pageIndex` integer
- `pageSize` integer

## Response `200`

OK

- PagedResponsePurchaseCore
  - `success` boolean
  - `error` string
  - `pageRequest` PageRequest
    - `pageIndex` integer
    - `pageSize` integer
  - `totalItemCount` integer
  - `items` PurchaseCore[]
    - `audit` Audit
      - `createdTime` string, date-time
      - `modifiedTime` string, date-time
      - `modifiedBy` string
    - `purchaseId` integer
    - `membershipId` integer
    - `token` string, uuid
    - `member` MemberSlim
      - `userMembershipId` integer
      - `membershipId` integer
      - `username` string
      - `firstName` string
      - `middleName` string
      - `lastName` string
      - `email` string
      - `phone` string
      - `membershipNumber` string
      - `fullName` string
      - `isPrimary` boolean
    - `guest` GuestCore
      - `audit` Audit
        - `createdTime` string, date-time
        - `modifiedTime` string, date-time
        - `modifiedBy` string
      - `guestId` integer
      - `firstName` string
      - `lastName` string
      - `email` string
      - `phone` string
      - `postalCode` string
    - `voucher` ProductVoucherCore
      - `audit` Audit
        - `createdTime` string, date-time
        - `modifiedTime` string, date-time
        - `modifiedBy` string
      - `productVoucherId` integer
      - `code` string
      - `description` string
      - `discountAmount` integer
      - `discountPercent` integer
      - `maxRedemptions` integer
      - `autoApplied` boolean
      - `active` boolean
      - `startDateTime` string, date-time
      - `endDateTime` string, date-time
    - `gatewayType` 'STRIPE'
    - `gatewayPaymentId` string
    - `currency` 'AED' | 'ARS' | 'AUD' | 'CAD' | 'CHF' | 'CLP' | 'CNY' | 'EUR' | 'GBP' | 'INR' | 'JPY' | 'KRW' | 'MYR' | 'NZD' | 'PKR' | 'SGD' | 'USD' | 'ZAR'
    - `totalDue` integer
    - `totalPaid` integer
    - `totalTax` integer
    - `totalDiscount` integer
    - `totalCredit` integer
    - `totalRefunded` integer
    - `totalDisputed` integer
    - `gatewayFee` integer
    - `applicationFee` integer
    - `disputeFee` integer
    - `serviceCharge` integer
    - `net` integer
    - `paymentCompleteTime` string, date-time
    - `paymentFailTime` string, date-time
    - `fulfillTime` string, date-time
    - `cancelTime` string, date-time
    - `partialRefundTime` string, date-time
    - `refundTime` string, date-time
    - `disputeLostTime` string, date-time
    - `status` 'PENDING' | 'COMPLETED' | 'FAILED' | 'REFUNDED' | 'DISPUTE_LOST' | 'CANCELLED'
  - `totalPages` integer
  - `itemCount` integer
  - `isFirst` boolean
  - `isLast` boolean
  - `hasNext` boolean
  - `hasPrevious` boolean

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `500`: Internal server error

## Changes

- **2026-09-02** `870f28ba2607`: 5 info
  - added the optional property `error/errorId` to the response with the `400` status
  - added the optional property `error/errorId` to the response with the `401` status
  - added the optional property `error/errorId` to the response with the `403` status
  - added the optional property `error/errorId` to the response with the `404` status
  - …1 more

[Operation history](https://skmtc.dev/mobilecoach/apis/untitled-api/changes/api/product-vouchers/:productVoucherId/purchases/get.md)

---

[API](https://skmtc.dev/mobilecoach/apis/untitled-api.md) - [All operations](https://skmtc.dev/mobilecoach/apis/untitled-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mobilecoach/apis/untitled-api/revisions/6e5d224eed9b?raw)