---
title: "Get payment events list with pagination and filters"
method: GET
path: "/admin/payment-events"
tags: ["Admin"]
---

# Get payment events list with pagination and filters

`GET /admin/payment-events`

Retrieve a paginated list of payment events with optional filtering by user, notification type, subtype, and currency. Amounts are calculated as positive for income and negative for expenses.

## Query parameters

- `page` number
- `limit` number
- `userId` string
- `firebaseUserId` string
- `notificationType` 'SUBSCRIBED' | 'DID_CHANGE_RENEWAL_PREF' | 'DID_CHANGE_RENEWAL_STATUS' | 'OFFER_REDEEMED' | 'DID_RENEW' | 'EXPIRED' | 'DID_FAIL_TO_RENEW' | 'GRACE_PERIOD_EXPIRED' | 'PRICE_INCREASE' | 'REFUND' | 'REFUND_DECLINED' | 'CONSUMPTION_REQUEST' | 'RENEWAL_EXTENDED' | 'REVOKE' | 'TEST' | 'RENEWAL_EXTENSION' | 'REFUND_REVERSED' | 'EXTERNAL_PURCHASE_TOKEN' | 'ONE_TIME_CHARGE'
- `subtype` 'INITIAL_BUY' | 'RESUBSCRIBE' | 'DOWNGRADE' | 'UPGRADE' | 'AUTO_RENEW_ENABLED' | 'AUTO_RENEW_DISABLED' | 'VOLUNTARY' | 'BILLING_RETRY' | 'PRICE_INCREASE' | 'GRACE_PERIOD' | 'PENDING' | 'ACCEPTED' | 'BILLING_RECOVERY' | 'PRODUCT_NOT_FOR_SALE' | 'SUMMARY' | 'FAILURE' | 'UNREPORTED'
- `currency` string
- `productType` 'AUTO_RENEWABLE' | 'NON_RENEWABLE' | 'CONSUMABLE' | 'NON_CONSUMABLE'

## Response `200`

Payment events list retrieved successfully

- PaymentEventsListResponseDto
  - `paymentEvents` PaymentEventItemDto[], required — List of payment events
    - `type` 'AUTO_RENEWABLE' | 'NON_RENEWABLE' | 'CONSUMABLE' | 'NON_CONSUMABLE', nullable, required — Product Type
    - `subtype` 'INITIAL_BUY' | 'RESUBSCRIBE' | 'DOWNGRADE' | 'UPGRADE' | 'AUTO_RENEW_ENABLED' | 'AUTO_RENEW_DISABLED' | 'VOLUNTARY' | 'BILLING_RETRY' | 'PRICE_INCREASE' | 'GRACE_PERIOD' | 'PENDING' | 'ACCEPTED' | 'BILLING_RECOVERY' | 'PRODUCT_NOT_FOR_SALE' | 'SUMMARY' | 'FAILURE' | 'UNREPORTED', nullable, required — Subtype
    - `currency` string, nullable, required — Currency
    - `calculatedAmount` number, required — Calculated Amount (positive for income, negative for expense)
    - `isIncome` boolean, required — Is Income
    - `isExpense` boolean, required — Is Expense
    - `eventName` string, required — Human-readable event name
    - `productId` string, nullable, required — Product ID
    - `purchaseDate` string, date-time, nullable, required — Purchase Date
  - `total` number, required — Total number of payment events
  - `page` number, required — Current page number
  - `limit` number, required — Number of items per page
  - `totalPages` number, required — Total number of pages

---

[API](https://skmtc.dev/miaai/apis/backend-template-api.md) · [All operations](https://skmtc.dev/miaai/apis/backend-template-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/miaai/backend-template-api/revisions/2a8d88a5124f/schema)