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

# List subscriptions

`GET /subscriptions`

## Request

- Base URL: `https://api.sandbox.cleeng.com/3.1`
- URL: `https://api.sandbox.cleeng.com/3.1/subscriptions`
- Auth: API key in header `X-Publisher-Token`

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.dev/cleeng/apis/api-31.md) - [All operations](https://skmtc.dev/cleeng/apis/api-31/llms.txt) - [OpenAPI document](https://skmtc.dev/cleeng/apis/api-31/revisions/df55396cda4f?raw)