---
title: "List subscriptions"
method: GET
path: "/appReseller/v1/subscriptions"
tags: ["AppResellerSubscription"]
---

# List subscriptions

`GET /appReseller/v1/subscriptions`

## Request

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

Note: This endpoint is being deprecated. // Retrieves a list of all user subscriptions of a linked company. You can filter the list using optional query parameters.

## Query parameters

- `context` 'RESELLER, RESELLER_MANAGER', required
- `number` integer
- `size` integer
- `sort` string
- `userId` string
- `resellerCompanyId` string, required
- `customerCompanyId` string, required
- `createdOn` string
- `status` 'INITIALIZED' | 'FAILED' | 'FREE_TRIAL' | 'FREE_TRIAL_EXPIRED' | 'ACTIVE' | 'SUSPENDED' | 'CANCELLED'
- `paidStatus` 'PAID, FREE'
- `pending` boolean
- `searchText` string

## Response `200`

Success

- SubscriptionList
  - `page` PageMetadata, required
    - `number` number, required: Page number
    - `size` number, required: Size of the page to be returned
    - `totalElements` number, required: Total number of elements
    - `totalPages` number, required: Total number of pages
  - `content` AppResellerSubscriptionLightWS[], required: List of subscriptions
    - `id` string, required: Subscription ID
    - `activeOrder` AppResellerOrderLightWS, 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
    - `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)

## Other responses

- `401`: Unauthorized

## Changes

- **2026-11-06** `1fc240f06971`: 1 breaking, 2 info
  - the response's body type changed from no type to `object` for status `200`
  - added the required property `content` to the response with the `200` status
  - added the required property `page` to the response with the `200` status

[Operation history](https://skmtc.dev/appdirect/apis/companies/changes/appReseller/v1/subscriptions/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)