---
title: "List user subscriptions"
method: GET
path: "/v2/user/subscriptions"
tags: ["users"]
---

# List user subscriptions

`GET /v2/user/subscriptions`

## Response `200`

OK

- object — List of subscriptions
  - `data` object[] — Subscriptions retrieved from this user
    - `allotment` object — An allotment of credits as part of a subscription
      - `downloads_left` integer — Number of credits remaining in the subscription
      - `downloads_limit` integer — Total number of credits available to this subscription
      - `end_time` string, date-time — Date the subscription ends
      - `start_time` string, date-time — Date the subscription started
      - `content_tiers` object — Downloads left and limit values for each content tier in the license
    - `description` string — Description of the subscription
    - `expiration_time` string, date-time — Date the subscription ends
    - `formats` object[] — List of formats that are licensable for the subscription
      - `description` string — Description of the license
      - `format` string — Format or extension of the media, such as mpeg for videos or jpeg for images
      - `media_type` 'image' | 'video' | 'audio' | 'editorial' — Media type of the license
      - `min_resolution` integer — Width of the media, in pixels, allowed by this license
      - `size` string — Keyword that details the size of the media, such as hd or sd for video, huge or vector for images
    - `id` string, required — Unique internal identifier for the subscription
    - `license` string — Internal identifier for the type of subscription
    - `asset_type` string — Identifier for the type of assets associated with this subscription (images, videos, audio, editorial)
    - `metadata` object — Subscription metadata; different for each customer
    - `price_per_download` object — Price
      - `local_amount` number — Floating-point amount of the calculated rev-share price in the currency local_currency
      - `local_currency` string — Currency of the rev-share price that was calculated
  - `errors` object[] — Error list; appears only if there was an error
    - `code` string — The error code of this error
    - `data` string — Debugging information about the error
    - `items` object[] — A list of items that produced the error
    - `message` string, required — Specific details about this error
    - `path` string — Internal code reference to the source of the error
  - `message` string — Optional error message
  - `page` integer — Current page that is being queried
  - `per_page` integer — Amount of subscriptions to show per page
  - `total_count` integer — Total number of subscriptions for this user

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden

---

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