---
title: "List subscription assignments"
method: GET
path: "/appReseller/v1/subscriptionAssignments"
tags: ["AppResellerAssignment"]
---

# List subscription assignments

`GET /appReseller/v1/subscriptionAssignments`

## Request

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

Retrieves a list of assignments for a given subscription. You can filter the list using optional query parameters.

## Query parameters

- `number` integer
- `size` integer
- `sort` string
- `createdOn` string
- `status` string
- `subscriptionId` string, required
- `userId` string

## Response `200`

Success

- AppResellerSubscriptionAssignmentList: Assignment of a product to a user
  - `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` AppResellerSubscriptionAssignmentWS[], required: List of subscription assignments
    - `id` string, required: Assignment ID
    - `status` 'PENDING_REQUIRED_DATA' | 'PENDING_SEAT_AVAILABILITY' | 'PENDING_USER_ACTIVATION' | 'PENDING_REMOTE_CREATION' | 'SUBSCRIPTION_SUSPENDED_FREE_TRIAL_EXPIRED' | 'SUBSCRIPTION_SUSPENDED_RENEW_CONTRACT' | 'SUBSCRIPTION_SUSPENDED_PAY_INVOICE' | 'SUBSCRIPTION_SUSPENDED_MANUAL_SUSPENSION' | 'FAILED' | 'ACTIVE' | 'PENDING_REMOTE_CANCELLATION' | 'CANCELLED', required
    - `createdOn` number, required: Assignment creation date, in timestamp format
    - `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
    - `subscriptionId` string, required: ID of the subscription assigned to the user

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