---
title: "List Reseller Subscriptions"
method: GET
path: "/v1/reseller/subscriptions"
tags: ["Reseller"]
---

# List Reseller Subscriptions

`GET /v1/reseller/subscriptions`

Shows subscriptions associated with the current reseller's managed accounts.

**Note:** This endpoint will also return a `pagination` key on the root
level. Please refer to the [pagination
section](https://api.huntress.io/docs#pagination) within our docs for
more information.

## Query parameters

- `limit` integer
- `page_token` string
- `sort_field` 'id' | 'status' | 'minimum' | 'created_at' | 'updated_at'
- `sort_direction` 'asc' | 'desc'
- `product` 'edr' | 'ispm' | 'itdr' | 'sat' | 'siem'
- `status` 'draft' | 'approved' | 'accepted' | 'active' | 'completed'

## Response `200`

List Reseller Subscriptions

- object
  - `subscriptions` Subscription[], required
    - `id` integer — A unique identifier for the subscription.
    - `account` unknown
    - `product` 'edr' | 'ispm' | 'itdr' | 'sat' | 'siem' — The product type for this subscription.
    - `status` 'draft' | 'approved' | 'accepted' | 'active' | 'completed' — The subscription status.
    - `minimum_usage` integer — The current minimum usage commitment for this subscription.
    - `terminal_minimum_usage` integer — The minimum usage commitment for this subscription after all subscription schedules are completed. Usually, this will be the same as the current minimum, but it may be higher during an ongoing schedule.
    - `billing_interval` 'monthly' | 'annual' — The billing interval for this subscription.
    - `effective_date` string — ISO-8601 formatted date when this subscription becomes effective.
    - `renewal_date` string — ISO-8601 formatted date when this subscription renews.
    - `auto_renew` boolean — Whether this subscription will auto-renew.
    - `schedules` SubscriptionSchedule[] — The schedules associated with this subscription.
      - `id` integer — A unique identifier for the subscription schedule.
      - `minimum` integer — The minimum usage commitment for this schedule period.
      - `maximum` integer — The maximum usage limit for this schedule period.
      - `status` 'active' | 'completed' | 'pending' — The schedule status.
      - `target_price` integer — The target price per unit for this schedule period.
      - `months` integer — The number of months this schedule period covers.
      - `promo_units` integer — The number of promotional units for this schedule period.
      - `starts_at` string — ISO-8601 formatted date when this schedule period starts.
      - `ends_at` string — ISO-8601 formatted date when this schedule period ends.
  - `pagination` Pagination, required — Pagination model
    - `next_page_url` string
    - `next_page_token` string

## Other responses

- `400` — Invalid query parameters
- `403` — There was an issue with your API credential or permissions.

---

[API](https://skmtc.net/huntress/apis/huntress-api-reference.md) · [All operations](https://skmtc.net/huntress/apis/huntress-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/huntress/huntress-api-reference/revisions/94acb422c07d/schema)