---
title: "GET /subscriptions/assets"
method: GET
path: "/subscriptions/assets"
tags: ["Subscriptions"]
---

# GET /subscriptions/assets

`GET /subscriptions/assets`

## Query parameters

- `limit` integer
- `offset` integer
- `billing.next_date` string, date-time
- `billing.period.uom` 'monthly' | 'yearly' | 'years_2' | 'years_3' | 'years_4' | 'years_5' | 'years_6'
- `connection.hub.id` string
- `connection.hub.name` string
- `connection.id` string
- `connection.provider.id` string
- `connection.provider.name` string
- `connection.type` 'test' | 'production' | 'preview'
- `connection.vendor.id` string
- `connection.vendor.name` string
- `contract.id` string
- `events.created.at` string, date-time
- `events.updated.at` string, date-time
- `external_id` string
- `external_uid` string
- `id` string
- `items` string
- `marketplace.id` string
- `marketplace.name` string
- `params.id` string
- `params.name` string
- `params.value` string
- `pending_request` string
- `pending_request.template` string
- `product.id` string
- `product.name` string
- `status` 'draft' | 'processing' | 'active' | 'terminating' | 'suspended' | 'terminated'
- `template` string
- `tiers.customer.id` string
- `tiers.customer.name` string
- `tiers.tier1.id` string
- `tiers.tier2.id` string

## Response `200`

- SubscriptionsSubscriptions[]
  - `id` string
  - `status` 'draft' | 'processing' | 'active' | 'terminating' | 'suspended' | 'terminated'
  - `events` object
    - `created` object
      - `at` string, datetime
      - `by` object
        - `id` string
        - `name` string
        - `icon` string
    - `updated` object
      - `at` string, datetime
      - `by` object
        - `id` string
        - `name` string
        - `icon` string
  - `external_id` string, nullable
  - `external_uid` string, nullable
  - `product` SubscriptionsProduct
    - `id` string
    - `name` string, required
    - `status` string, required
    - `icon` string
    - `preferred_names` string
  - `connection` SubscriptionsConnection — Connection Serializer that handle syndication asset representation In scope of vendor as provider returns Hyper Provider instance from syndicated data Require 'asset' to be passed in context
    - `id` string
    - `type` 'test' | 'production' | 'preview', nullable
    - `provider` SubscriptionsAccount
      - `id` string
      - `name` string, required
      - `icon` string, nullable
    - `vendor` SubscriptionsAccount
      - `id` string
      - `name` string, required
      - `icon` string, nullable
    - `hub` SubscriptionsHub
      - `id` string
      - `name` string, required
  - `items` SubscriptionsItemSubscriptionReference[]
    - `id` string, required
    - `global_id` string, required
    - `display_name` string, required
    - `mpn` string, required
    - `item_type` string, required
    - `period` string, required
    - `quantity` number
    - `type` string, required
  - `params` SubscriptionsParameter[]
    - `id` string, required
    - `name` string, required
    - `description` string, required
    - `type` string, required
    - `value` string, nullable
    - `value_error` string, nullable
    - `structured_value` object, nullable
  - `tiers` object
    - `customer` SubscriptionsTierAccount
      - `id` string
      - `external_id` string, nullable
      - `external_uid` string, nullable
      - `name` string
      - `tax_id` string, nullable
      - `contact_info` object
        - `address_line1` string, required
        - `address_line2` string
        - `city` string, required
        - `state` string
        - `postal_code` string, required
        - `country` string, required
        - `contact` object, required
          - `first_name` string, required
          - `last_name` string, required
          - `email` string, email, required
          - `phone_number` object, required
            - `country_code` string
            - `area_code` string
            - `phone_number` string
            - `extension` string
    - `tier1` SubscriptionsTierAccount
      - `id` string
      - `external_id` string, nullable
      - `external_uid` string, nullable
      - `name` string
      - `tax_id` string, nullable
      - `contact_info` object
        - `address_line1` string, required
        - `address_line2` string
        - `city` string, required
        - `state` string
        - `postal_code` string, required
        - `country` string, required
        - `contact` object, required
          - `first_name` string, required
          - `last_name` string, required
          - `email` string, email, required
          - `phone_number` object, required
            - `country_code` string
            - `area_code` string
            - `phone_number` string
            - `extension` string
    - `tier2` SubscriptionsTierAccount
      - `id` string
      - `external_id` string, nullable
      - `external_uid` string, nullable
      - `name` string
      - `tax_id` string, nullable
      - `contact_info` object
        - `address_line1` string, required
        - `address_line2` string
        - `city` string, required
        - `state` string
        - `postal_code` string, required
        - `country` string, required
        - `contact` object, required
          - `first_name` string, required
          - `last_name` string, required
          - `email` string, email, required
          - `phone_number` object, required
            - `country_code` string
            - `area_code` string
            - `phone_number` string
            - `extension` string
  - `marketplace` SubscriptionsMarketplace
    - `id` string
    - `name` string, required
    - `icon` string, nullable
  - `contract` SubscriptionsContract
    - `id` string
    - `name` string, required
  - `billing` object
    - `period` object
      - `delta` number
      - `uom` 'monthly' | 'yearly' | 'years_2' | 'years_3' | 'years_4' | 'years_5' | 'years_6'
    - `next_date` string, date-time
    - `anniversary` object
      - `day` integer
      - `month` integer
  - `template` SubscriptionsTemplateReference, required
    - `id` string
    - `name` string, required
  - `pending_request` SubscriptionsPendingRequest, required
    - `id` string
    - `type` 'purchase' | 'cancel' | 'change' | 'suspend' | 'resume' | 'adjustment' | 'renew'
    - `status` 'draft' | 'tiers_setup' | 'pending' | 'inquiring' | 'approved' | 'failed' | 'scheduled' | 'revoking' | 'revoked' | 'queued'
    - `template` SubscriptionsTemplateReference, required
      - `id` string
      - `name` string, required
  - `renewal_expiration_date` string, date-time, nullable

## Other responses

- `400`

---

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