---
title: "Get purchases by org (with optional pagination and search criteria). Roles: admin."
method: GET
path: "/api/memberships/{membershipId}/purchases"
tags: ["Purchases", "Organizations"]
---

# Get purchases by org (with optional pagination and search criteria). Roles: admin.

`GET /api/memberships/{membershipId}/purchases`

## Path parameters

- `membershipId` integer, required

## Query parameters

- `pageIndex` integer
- `pageSize` integer
- `purchaseStatus` 'PENDING' | 'COMPLETED' | 'FAILED' | 'REFUNDED' | 'DISPUTE_LOST' | 'CANCELLED'
- `purchaserName` string
- `voucherCode` string

## 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

[Change history](https://skmtc.dev/mobilecoach/apis/untitled-api/changes/api/memberships/:membershipId/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-service-production.skmtc.workers.dev/v1/apis/mobilecoach/untitled-api/revisions/870f28ba2607/schema)