REST Examples: Retrieving a List of Payments in a Subscription {#retrieve-list-payments-in-sub-ex}
==================================================================================================

Successful Response

```
{
    "_links": {
        "self": {
            "href": "/rbs/v1/subscriptions/7713669249636014301951/payments",
            "method": "GET"
        },
        "update": {
            "href": "/rbs/v1/subscriptions/7713669249636014301951/payments",
            "method": "PUT"
        }
    },
    "submitTimeUtc": "2026-02-25T15:34:38.057Z",
    "totalCount": 6,
    "cyclesCompletedCount": {
        "paid": 1
    },
    "billingCyclesToSkip": [
        4,
        5
    ],
    "subscriptionPayment": [
        {
            "id": "20000214748364800000010011771366925290",
            "status": "SCHEDULED",
            "paymentType": "STANDARD",
            "date": "2026-07-17T09:00:00.000Z",
            "currency": "GBP",
            "billingStartDate": "2026-07-17T07:00:00.000Z",
            "billingEndDate": "2026-08-17T06:59:59.000Z",
            "billingCycle": "6",
            "paymentNumber": "6",
            "billingAmount": "250.00",
            "surchargeAmount": "0.00",
            "surchargeDescription": "Surcharge Description",
            "modifiable": true
        },
        {
            "id": "20000214748364800000010011771366925290",
            "status": "SCHEDULED_SKIPPED",
            "paymentType": "STANDARD",
            "date": "2026-06-17T09:00:00.000Z",
            "currency": "GBP",
            "billingStartDate": "2026-06-17T07:00:00.000Z",
            "billingEndDate": "2026-07-17T06:59:59.000Z",
            "billingCycle": "5",
            "paymentNumber": "5",
            "billingAmount": "250.00",
            "surchargeAmount": "0.00",
            "surchargeDescription": "Surcharge Description",
            "modifiable": true
        },
        {
            "id": "20000214748364800000010011771366925290",
            "status": "SCHEDULED_SKIPPED",
            "paymentType": "STANDARD",
            "date": "2026-05-17T09:00:00.000Z",
            "currency": "GBP",
            "billingStartDate": "2026-05-17T07:00:00.000Z",
            "billingEndDate": "2026-06-17T06:59:59.000Z",
            "billingCycle": "4",
            "paymentNumber": "4",
            "billingAmount": "250.00",
            "surchargeAmount": "0.00",
            "surchargeDescription": "Surcharge Description",
            "modifiable": true
        },
        {
            "id": "20000214748364800000010011771366925290",
            "status": "SCHEDULED",
            "paymentType": "STANDARD",
            "date": "2026-04-17T09:00:00.000Z",
            "currency": "GBP",
            "billingStartDate": "2026-04-17T07:00:00.000Z",
            "billingEndDate": "2026-05-17T06:59:59.000Z",
            "billingCycle": "3",
            "paymentNumber": "3",
            "billingAmount": "250.00",
            "surchargeAmount": "0.00",
            "surchargeDescription": "Surcharge Description",
            "modifiable": true
        },
        {
            "id": "20000214748364800000010011771366925290",
            "status": "SCHEDULED",
            "paymentType": "STANDARD",
            "date": "2026-03-17T09:00:00.000Z",
            "currency": "GBP",
            "billingStartDate": "2026-03-17T07:00:00.000Z",
            "billingEndDate": "2026-04-17T06:59:59.000Z",
            "billingCycle": "2",
            "paymentNumber": "2",
            "billingAmount": "250.00",
            "surchargeAmount": "0.00",
            "surchargeDescription": "Surcharge Description",
            "modifiable": true
        },
        {
            "id": "20000214748364800000010011771366925292",
            "status": "PAID",
            "paymentType": "STANDARD",
            "transactionID": "7713669249636014301951",
            "date": "2026-02-17T22:22:07.895Z",
            "currency": "GBP",
            "billingStartDate": "2026-02-17T08:00:00.000Z",
            "billingEndDate": "2026-03-17T06:59:59.000Z",
            "billingCycle": "1",
            "paymentNumber": "1",
            "billingAmount": "250.00",
            "setupFee": "10.00",
            "surchargeAmount": "0.00",
            "surchargeDescription": "Surcharge Description",
            "modifiable": false
        }
    ]
}
```

Error Response

```
{
    "submitTimeUtc": "2026-02-25T14:29:19.160Z",
    "status": "NOT_FOUND",
    "reason": "INVALID_DATA",
    "message": "Subscription with given ID not found."
}
```