---
title: "Fetch customer's subscriptions"
method: GET
path: "/customers/{customerId}/subscriptions"
---

# Fetch customer's subscriptions

`GET /customers/{customerId}/subscriptions`

Use `/customers/:customerId/subscriptions` endpoint to fetch customer's subscriptions. This endpoint lists all active and stopped subscriptions, but it doesn't return expired ones.

You can find details about customer subscriptions here, like status, expiration date, price, payment method, or period.

>**NOTE:** This API requires <<glossary:JWT>> to run. It should be put in the request header. See more in [Authorization](https://developers.cleeng.com/reference/getting-started#authorization).

## Path parameters

- `customerId` string, required

## Response `200`

200

- object
  - `responseData` object
    - `items` object[]
      - `subscriptionId` integer
      - `offerId` string
      - `status` string
      - `startedAt` integer
      - `expiresAt` integer
      - `nextPaymentPrice` integer
      - `nextPaymentCurrency` string
      - `nextPaymentAt` integer
      - `paymentGateway` string
      - `paymentMethod` string
      - `externalPaymentId` string
      - `inTrial` boolean
      - `offerTitle` string
      - `period` string
      - `totalPrice` integer
  - `errors` unknown[]
    - unknown

## Other responses

- `400` — 400
- `401` — 401
- `500` — 500

---

[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)