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

# List entitlements

`GET /entitlements`

You can use this endpoint to list a customer's entitlements and calculate a subscription's length. You can fetch entitlements for two types of offer: **subscriptions** and **passes** only. (For more information on offers, see [What is a Cleeng offer?](https://publisher.support.cleeng.com/hc/en-us/articles/360012552919-What-is-a-Cleeng-offer-)). <br><br> If there are two or more subscriptions or passes for the same offer and the same customer, there will be as many entitlements returned as there are subscriptions / passes.

## Query parameters

- `customerId` integer, required
- `customerEmail` string
- `offset` integer, required
- `limit` integer, required
- `status` string
- `offerType` string

## Response `200`

200

- object
  - `success` boolean
  - `data` object[]
    - `offerType` string
    - `offerId` string
    - `customerId` integer
    - `status` string
    - `expiresAt` integer
    - `startedAt` integer
  - `nextPage` boolean
  - `message` string

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