Get subscription payments

METHOD	URL
GET	/subscriptions/{subscriptionId}/payments?page={page}&pageSize={pageSize}
EXAMPLE	https://test.api.revuppayments.com/v2/subscriptions/{subscriptionId}/payments?page={page}&pageSize={pageSize}

Endpoint to get subscription payments.

Success responses - Get subscription payments

HTTP CODE	DESCRIPTION
200	Subscription payments are provided in the body in JSON format.

Success response example - Get subscription payments

{
    "payments": [
        {
            "paymentId": "019a2618-15f2-71f4-bbb2-dd33cb76407c",
            "planId": "8dc803d2-a119-4698-82d5-d1393b4398ab",
            "paymentType": "initial",
            "paymentCycle": 0,
            "numAttempt": 0,
            "status": "accepted",
            "dueDate": "2025-10-27T14:34:53.104Z",
            "cycleReferenceDate": "2025-10-27T14:34:53.104Z",
            "amount": 15.5,
            "currency": "EUR",
            "transactions": [
                {
                    "transactionId": "459e77d1-df2a-4213-8cb7-d49463e3f4eb",
                    "transactionDate": "2025-10-27T14:34:56.857Z",
                    "transactionStatus": "success",
                    "transactionType": "payment"
                }
            ]
        },
        {
            "paymentId": "019a2618-27d8-7caf-bf2e-4a269353a20e",
            "planId": "8dc803d2-a119-4698-82d5-d1393b4398ab",
            "paymentType": "renewal",
            "paymentCycle": 1,
            "numAttempt": 0,
            "status": "accepted",
            "dueDate": "2025-11-03T17:00:00Z",
            "overriddenDueDate": "2025-10-27T14:35:10.074159Z",
            "cycleReferenceDate": "2025-11-03T17:00:00Z",
            "amount": 30.0,
            "currency": "EUR",
            "transactions": [
                {
                    "transactionId": "859bd586-77a0-473d-86e0-445da899e8de",
                    "transactionDate": "2025-10-27T14:35:18.688Z",
                    "transactionStatus": "success",
                    "transactionType": "payment"
                },
                {
                    "transactionId": "90ed615e-2414-4c10-accb-ebf382b01f07",
                    "transactionDate": "2026-09-08T15:11:24.094779Z",
                    "transactionStatus": "success",
                    "transactionType": "refund",
                    "refundType": "Manual Refund from Merchant"
                }
            ]
        },
        {
            "paymentId": "019a2618-754d-7a95-aa0f-f2a5542778a3",
            "planId": "8dc803d2-a119-4698-82d5-d1393b4398ab",
            "paymentType": "renewal",
            "paymentCycle": 2,
            "numAttempt": 0,
            "status": "pending",
            "dueDate": "2025-12-01T17:00:00Z",
            "cycleReferenceDate": "2025-12-01T17:00:00Z",
            "amount": 30.0,
            "currency": "EUR"
        }
    ],
    "pagination": {
        "totalRecords": 3,
        "currentPage": 1,
        "pageSize": 10,
        "totalPages": 1
    }
}

---

Error responses - Get subscriptions

HTTP CODE	ERROR CODE	ERROR MESSAGE	DESCRIPTION
500	0900	Internal Server Error	The server experienced an unexpected error.