App Store subscribers (DB-backed + live-enriched)

GET

/api/v2/admin/store/appstore/subscribers

Enumerate App Store subscribers from UserPlanTransaction (reference = Apple originalTransactionId) and enrich each with a live App Store Server API getSubscriptionStatuses lookup.

• If token (an originalTransactionId) is provided, returns just that subscriber; the live lookup runs even with no matching DB row.
• If token is omitted, lists all App Store subscribers (latest transaction per originalTransactionId, so renewals are collapsed to one row per subscriber), paginated and each enriched live unless enrich=false.

Note: enrichment fires one live Apple call per row (fault-isolated, concurrent). Use enrich=false for fast browsing.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

Responses

🟢200

application/json

Subscribers fetched (single-subscriber shape when token is provided, paginated list otherwise)

Bodyapplication/json

🟠404NotFound

Request Example

Shell

JavaScript

Java

Swift

curl --location '/api/v2/admin/store/appstore/subscribers?token=undefined&enrich=undefined&userId=undefined&status=undefined&search=undefined&startDate=undefined&endDate=undefined&page=undefined&limit=undefined' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "success": true,
    "message": "App Store subscriber fetched successfully!",
    "data": {
        "originalTransactionId": "string",
        "transaction": {
            "id": 0,
            "userId": 0,
            "planId": 0,
            "planPriceId": 0,
            "email": "string",
            "amount": 0,
            "reference": "string",
            "currency": "string",
            "status": "string",
            "channel": "string",
            "platform": "PLAYSTORE",
            "planName": "string",
            "userPlanId": 0,
            "createdAt": "2019-08-24T14:15:22.123Z",
            "updatedAt": "2019-08-24T14:15:22.123Z",
            "user": {},
            "planPrice": {}
        },
        "liveStatus": {},
        "liveStatusError": "string"
    }
}

Modified at 2026-07-22 03:18:43

App Store notification history (live)

Play Store notification history (from stored RTDNs)