---
title: "Subscription details"
method: GET
path: "/appReseller/v1/subscriptions/{subscriptionId}"
tags: ["AppResellerSubscription"]
---

# Subscription details

`GET /appReseller/v1/subscriptions/{subscriptionId}`

## Request

- Base URL: `https://marketplace.appdirect.com/api`
- URL: `https://marketplace.appdirect.com/api/appReseller/v1/subscriptions/{subscriptionId}`
- Auth: none declared
- TypeScript: <https://skmtc.dev/appdirect/apis/companies/docs/appReseller/v1/subscriptions/:subscriptionId/get.ts> (a function with typed inputs; its response is checked against the schema)

Note: This endpoint is being deprecated. // Read a subscription by ID

## Path parameters

- `subscriptionId` string, required

## Response `200`

Success

- AppResellerSubscriptionWS
  - `id` string, required: Subscription ID
  - `createdOn` number, required: Creation date of the subscription, in Unix timestamp format
  - `activeOrder` AppResellerSubscriptionActiveOrderWS, required
    - `id` string, required: Order ID
    - `createdOn` number, required: Creation date of the order, in Unix timestamp format
    - `status` string, required: Order status (valid values are INITIALIZED, PENDING_USER_APPROVAL, PENDING_REMOTE_CREATION, PENDING_MANUAL_RECOVERY, PENDING_ASYNCHRONOUS_CREATION, FREE_TRIAL, ACTIVE, FINISHED, ONE_TIME, CANCELLED, SUSPENDED, FREE_TRIAL_EXPIRED, FREE_TRIAL_CANCELLED, DELETED, FAILED, UPCOMING, PENDING_MIGRATION_ACTIVATION, PENDING_DELAYED_PROVISIONING)
    - `frequency` string, required: Frequency (valid values are MONTHLY, QUARTERLY, SIX_MONTHS, YEARLY, TWO_YEARS, THREE_YEARS, DAILY)
    - `totalFee` string, required: Total fee for the order
    - `editionName` string, required: Edition name
    - `orderCartId` string: Order cart ID
    - `orderLines` OrderLineDetailsWS[]: Unit type and quantity
      - `unit` string, nullable, required: Pricing Unit
      - `quantity` string, nullable, required: Quantity
    - `paymentPlanId` string: Edition Payment Plan ID
  - `company` CompanyAssociation, required: A minimum version of a company: includes only the company ID and name
    - `id` string, required: Company ID
    - `name` string, required: Company name
  - `user` UserAssociation, required: A minimum version of a user: includes only the user ID, first name, and last name
    - `id` string, required: User ID
    - `firstName` string, required: User first name
    - `lastName` string, required: User last name
  - `applicationName` string, required: Name of the application related to the subscription
  - `pendingEventType` 'SUBSCRIPTION_ORDER' | 'SUBSCRIPTION_CHANGE' | 'SUBSCRIPTION_CANCEL' | 'SUBSCRIPTION_NOTICE' | 'USER_ASSIGNMENT' | 'USER_UNASSIGNMENT' | 'USER_UPDATED' | 'ADDON_ORDER' | 'ADDON_CHANGE' | 'ADDON_CANCEL' | 'ADDON_BIND' | 'ADDON_UNBIND'
  - `status` string, required: Subscription status (valid values are INITIALIZED, FAILED, FREE_TRIAL, FREE_TRIAL_EXPIRED, ACTIVE, SUSPENDED, or CANCELLED)
  - `referenceCode` string: Code provided by Resellers and Sales Agents while purchasing a subscription

## Other responses

- `401`: Unauthorized
- `404`: Not found

## Changes

- **2026-11-06** `1fc240f06971`: 1 breaking, 9 info
  - the response's body type changed from no type to `object` for status `200`
  - added the optional property `pendingEventType` to the response with the `200` status
  - added the optional property `referenceCode` to the response with the `200` status
  - added the required property `activeOrder` to the response with the `200` status
  - …6 more

[Operation history](https://skmtc.dev/appdirect/apis/companies/changes/appReseller/v1/subscriptions/:subscriptionId/get.md)

---

[API](https://skmtc.dev/appdirect/apis/companies.md) - [All operations](https://skmtc.dev/appdirect/apis/companies/llms.txt) - [OpenAPI document](https://skmtc.dev/appdirect/apis/companies/revisions/1fc240f06971?raw)