---
title: "List subscription payments"
method: GET
path: "/v2/customers/{customerId}/subscriptions/{subscriptionId}/payments"
tags: ["Subscriptions API"]
---

# List subscription payments

`GET /v2/customers/{customerId}/subscriptions/{subscriptionId}/payments`

Retrieve all payments of a specific subscription.

The results are paginated.

## Query parameters

- `from` string
- `limit` integer, nullable
- `sort` 'asc' | 'desc'
- `profileId` string — The identifier referring to the [profile](get-profile) this entity belongs to. Most API credentials are linked to a single profile. In these cases the `profileId` can be omitted in the creation request. For organization-level credentials such as OAuth access tokens however, the `profileId` parameter is required.
- `testmode` boolean

## Headers

- `idempotency-key` string

## Response `200`

A list of payment objects.

## Other responses

- `400` — The request contains issues. For example, if the specified `from` value is not a valid ID.
- `429` — Rate Limit has been reached.

## Changes

> 92 revisions in range; 9 not diffed.

- **2026-09-15** `9c1c6717ac7d` — 3 warning
  - added the new `el_GR` enum value to the `_embedded/payments/items/allOf[#/components/schemas/list-entity-payment]/locale` response property for the response status `200`
  - added the new `sl_SI` enum value to the `_embedded/payments/items/allOf[#/components/schemas/list-entity-payment]/locale` response property for the response status `200`
  - added the new `tr_TR` enum value to the `_embedded/payments/items/allOf[#/components/schemas/list-entity-payment]/locale` response property for the response status `200`
- **2026-09-15** `34b0d7662c30` — 1 warning
  - added the new `undefined` enum value to the `_embedded/payments/items/allOf[#/components/schemas/list-entity-payment]/details/cardLabel` response property for the response status `200`
- **2026-09-14** `7eb5bf6b29dd` — 1 warning
  - added the new `undefined` enum value to the `_embedded/payments/items/allOf[subschema #2]/method` response property for the response status `200`
- **2026-09-07** `66dee9998c09` — 1 warning
  - added the new `wero` enum value to the `_embedded/payments/items/allOf[subschema #2]/method` response property for the response status `200`
- …earlier changes not shown

[Full history](https://skmtc.dev/mollie/apis/mollie-api/changes/v2/customers/:customerId/subscriptions/:subscriptionId/payments/get.md)

---

[API](https://skmtc.dev/mollie/apis/mollie-api.md) · [All operations](https://skmtc.dev/mollie/apis/mollie-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mollie/apis/mollie-api/revisions/b9d764add1c3?raw)