---
title: "List subscriptions"
method: GET
path: "/subscriptions"
---

# List subscriptions

`GET /subscriptions`

This endpoint returns subscriptions that match the specified criteria (`transactionId`, `paymentMethodId`, `externalId`, `customerId` or `offerId` and `customerId` together). Please bear in mind that if you don't provide any parameters, an empty list will be returned. <br><br> **Note:** Filtering by `customerId` and `offerId` might return multiple active subscriptions instead of one if [multiple subscriptions have been created for the same offer](https://developers.cleeng.com/docs/externally-managed-subscriptions#multiple-subscriptions-per-offer).

## Query parameters

- `customerId` integer
- `externalId` string
- `limit` integer
- `offerId` string
- `offset` integer
- `paymentMethodId` integer
- `status[]` string[]
- `transactionId` string

## Headers

- `Content-Type` string

## Response `200`

200

## Other responses

- `400` — 400

---

[API](https://skmtc.net/cleeng/apis/mediastore-api.md) · [All operations](https://skmtc.net/cleeng/apis/mediastore-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cleeng/mediastore-api/versions/00cbfe7998a4/schema)