client-pay-to-view-purchases.md
Client Pay-to-View Purchases
GET /client/v1/pay-to-view/purchases
Returns paginated list of pay-to-view purchases for the authenticated user.
Authentication
Requires a valid user token (UserAuthorizationFilter).
Query Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
page |
int |
Yes | — | Page number (1-based) |
pageSize |
int |
No | 10 |
Number of items per page |
Response
{
"items": [
{
"purchaseId": "string",
"userId": "string",
"payToViewProductId": 1,
"entityType": 0,
"entityId": "string",
"amountPaid": 9.99,
"currency": "USD",
"provider": 0,
"externalTransactionId": "string",
"status": 0,
"expiresAt": "2026-04-01T00:00:00Z",
"createdAt": "2026-03-01T12:00:00Z",
"updatedAt": "2026-03-01T12:05:00Z",
"entity": {
"name": "Video/Channel/Content name"
}
}
],
"totalCount": 25
}
Enum Values
entityType
| Value | Meaning |
|---|---|
1 |
Video |
2 |
Channel |
3 |
Content |
status
| Value | Meaning |
|---|---|
0 |
Pending |
1 |
Completed |
2 |
Refunded |
3 |
Failed |
4 |
Expired |
provider
| Value | Meaning |
|---|---|
1 |
Stripe |
2 |
Apple |
3 |
Notes
- Results are ordered by
createdAtdescending (newest first). - The
entityfield contains the name of the purchased video, channel, or content. It may benullif the referenced entity no longer exists. - The
userfield is not populated on this endpoint since it always returns the authenticated user's own purchases.