---
title: "Get a subscription"
method: GET
path: "/subscriptions/{subscriptionId}"
---

# Get a subscription

`GET /subscriptions/{subscriptionId}`

Use this endpoint to get subscription details based on subscription ID.

## Path parameters

- `subscriptionId` string, required

## Response `200`

200

- object
  - `subscriptionId` integer
  - `paymentDetailsId` integer
  - `publisherId` integer
  - `customerId` integer
  - `status` string
  - `dateFrom` integer
  - `dateTo` integer
  - `nextPaymentAction` string
  - `nextPaymentActionDate` integer
  - `subscriptionExternalId` string
  - `offerId` string
  - `paymentCountry` string
  - `ipAddress` unknown
  - `inTrial` boolean
  - `couponCode` unknown
  - `coupon` object
    - `discountRate` integer
    - `usageLeft` integer
  - `pendingSwitchId` string
  - `inProgressSwitchId` unknown
  - `externalProperties` object
    - `name1` string
    - `name2` string
  - `paymentMethodId` integer
  - `isExternallyManaged` boolean
  - `replacedBy` object
    - `subscriptionId` integer
    - `reason` string
    - `date` integer
  - `originatedFrom` object
    - `subscriptionId` integer
    - `reason` string
    - `date` integer
  - `source` string
  - `renewalCycle` object
    - `completed` integer
    - `unit` string
    - `amount` integer
  - `terminationType` unknown

## Other responses

- `404` — 404

---

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