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

# Fetch customer's offers

`GET /customers/{customerId}/offers`

## Request

- Base URL: `https://mediastoreapi-sandbox.cleeng.com`
- URL: `https://mediastoreapi-sandbox.cleeng.com/customers/{customerId}/offers`
- Auth: API key in header `Authorization`

Use this endpoint to fetch customer's offers (subscriptions and passes). 

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.

## Path parameters

- `customerId` integer, required

## Response `200`

200

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

## Other responses

- `400`: 400
- `423`: 423

## Changes

- **2026-11-03** `b4b65aa4f14c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/cleeng/apis/mediastore-api/changes/customers/:customerId/offers/get.md)

---

[API](https://skmtc.dev/cleeng/apis/mediastore-api.md) - [All operations](https://skmtc.dev/cleeng/apis/mediastore-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cleeng/apis/mediastore-api/revisions/b4b65aa4f14c?raw)