---
title: "List all subscriptions"
method: GET
path: "/v2/subscriptions"
tags: ["Subscriptions API"]
---

# List all subscriptions

`GET /v2/subscriptions`

Retrieve all subscriptions initiated across all your customers.

The results are paginated.

## Query parameters

- `from` string, nullable
- `limit` integer, nullable
- `profileId` string, nullable
- `testmode` boolean

## Headers

- `idempotency-key` string

## Response `200`

A list of subscription objects.

## Other responses

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

## Changes

> 48 revisions in range; 9 not diffed.

- **2026-06-15** `00fb770ca934` — 10 info
  - the response property `_embedded/subscriptions/items/allOf[#/components/schemas/list-entity-subscription]/_links` became required for the status `200`
  - the response property `_embedded/subscriptions/items/allOf[#/components/schemas/list-entity-subscription]/amount` became required for the status `200`
  - the response property `_embedded/subscriptions/items/allOf[#/components/schemas/list-entity-subscription]/createdAt` became required for the status `200`
  - the response property `_embedded/subscriptions/items/allOf[#/components/schemas/list-entity-subscription]/customerId` became required for the status `200`
  - …6 more
- **2026-06-09** `327472893a89` — 4 info
  - the response property `_embedded/subscriptions/items/allOf[#/components/schemas/list-entity-subscription]/_links/customer/href` became required for the status `200`
  - the response property `_embedded/subscriptions/items/allOf[#/components/schemas/list-entity-subscription]/_links/customer/type` became required for the status `200`
  - the response property `_embedded/subscriptions/items/allOf[#/components/schemas/list-entity-subscription]/_links/profile/href` became required for the status `200`
  - the response property `_embedded/subscriptions/items/allOf[#/components/schemas/list-entity-subscription]/_links/profile/type` became required for the status `200`
- …earlier changes not shown

[Full history](https://skmtc.dev/mollie/apis/mollie-api/changes/v2/subscriptions/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-service-production.skmtc.workers.dev/v1/apis/mollie/mollie-api/revisions/01ff4e7355c4/schema)