> ## Documentation Index
> Fetch the complete documentation index at: https://densify-sync-changelog-2.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# List subscriptions for a platform

> Returns a list of existing platform-specific subscriptions. Filters:
- `type` → all | global | owner
- `owner` (admin only) → list another user's private subs with `type=owner`
- `subscriptionRef` → return a single subscription by ID. 




## OpenAPI

````yaml /openapi/public_cloud/Subscriptions.yaml GET /subscriptions/{platformType}
openapi: 3.0.3
info:
  title: Kubex – Subscriptions API
  version: 1.0.0
  description: >
    Create and manage subscription-based notifications for Kubex cloud and
    container recommendations.

    - `GET /subscriptions/{platformType}` lists subscriptions with filters.

    - `POST /subscriptions/{platformType}` creates **one or more** subscriptions
    (bulk add, all-or-nothing).

    - `PUT /subscriptions/{platformType}/{subscriptionRef}` replaces an existing
    subscription.

    - `DELETE /subscriptions/{platformType}` deletes **one or more**
    subscriptions.

    - `DELETE /subscriptions/{platformType}/{subscriptionRef}` deletes a single
    subscription.

    Notes:

    • `platformType` is `cloud` or `containers`; `/subscriptions` (no platform)
    behaves like `/subscriptions/cloud` for backward compatibility. 
servers:
  - url: https://{host}
    variables:
      host:
        default: api.example.com
security: []
tags:
  - name: Subscriptions
paths:
  /subscriptions/{platformType}:
    get:
      tags:
        - Subscriptions
      summary: List subscriptions for a platform
      description: >
        Returns a list of existing platform-specific subscriptions. Filters:

        - `type` → all | global | owner

        - `owner` (admin only) → list another user's private subs with
        `type=owner`

        - `subscriptionRef` → return a single subscription by ID. 
      operationId: listSubscriptions
      parameters:
        - $ref: '#/components/parameters/platformType'
        - $ref: '#/components/parameters/type'
        - $ref: '#/components/parameters/owner'
        - $ref: '#/components/parameters/subscriptionRefQuery'
      responses:
        '200':
          $ref: '#/components/responses/SubscriptionList'
        '400':
          description: >-
            Bad Request (e.g. querying owner you don't own and you're not
            admin).
        '401':
          description: Authentication failed.
        '500':
          description: Server error.
components:
  parameters:
    platformType:
      name: platformType
      in: path
      required: true
      description: Technology platform (`cloud` or `containers`).
      schema:
        type: string
        enum:
          - cloud
          - containers
    type:
      name: type
      in: query
      required: false
      description: >
        Which subscriptions to list:

        - `all` (default): global + your private (admins see all)

        - `global`: all global

        - `owner`: user-specific; combine with `owner=` (admin can query any
        user) 
      schema:
        type: string
        enum:
          - all
          - global
          - owner
      example: owner
    owner:
      name: owner
      in: query
      required: false
      description: Kubex username to scope `type=owner` queries (admins only for others).
      schema:
        type: string
    subscriptionRefQuery:
      name: subscriptionRef
      in: query
      required: false
      description: Return details for a single subscription by ID.
      schema:
        type: string
  responses:
    SubscriptionList:
      description: Array of subscriptions
      content:
        application/json:
          schema:
            type: array
            items:
              $ref: '#/components/schemas/Subscription'
  schemas:
    Subscription:
      type: object
      properties:
        subscriptionRef:
          type: string
          description: Unique ID assigned to the subscription.
        subscriptionName:
          type: string
        description:
          type: string
        owner:
          type: string
          description: Empty for global; username for private.
        outputType:
          type: string
        active:
          type: string
          enum:
            - 'true'
            - 'false'
        webhook:
          $ref: '#/components/schemas/WebHook'
        propertyReferences:
          type: array
          items:
            $ref: '#/components/schemas/PropertyCondition'
        tagReferences:
          type: array
          items:
            $ref: '#/components/schemas/TagCondition'
        suppressionReferences:
          type: array
          items:
            $ref: '#/components/schemas/SuppressionCondition'
        returnStructure:
          $ref: '#/components/schemas/ReturnStructure'
        schedule:
          $ref: '#/components/schemas/Schedule'
        webhookStatus:
          type: string
          description: Success | Failure of last push to webhook (with timestamp).
        lastTriggered:
          type: string
          description: >-
            On-Demand Success/Failure or Scheduled Success/Failure with
            timestamp.
        message:
          type: string
          description: Error/status message (on error).
        status:
          type: integer
          description: HTTP-like status code (200, 204, 400, 401, 404, 415, 500).
      required:
        - subscriptionRef
        - subscriptionName
    WebHook:
      type: object
      properties:
        uri:
          type: string
          format: uri
        authType:
          type: string
        authValue:
          type: string
      required:
        - uri
      description: Webhook destination for delivering subscription notifications.
    PropertyCondition:
      type: object
      properties:
        propertyID:
          type: string
        operator:
          type: string
        values:
          type: array
          items:
            type: string
      required:
        - propertyID
        - operator
        - values
      description: >-
        Filter on recommendation fields. Requires at least one **core** property
        overall.
    TagCondition:
      type: object
      properties:
        tagID:
          type: string
        operator:
          type: string
        values:
          type: array
          items:
            type: string
      required:
        - tagID
        - operator
        - values
      description: Filter on system attributes (e.g., account, BU, app).
    SuppressionCondition:
      type: object
      properties:
        suppressionID:
          type: string
        operator:
          type: string
        values:
          type: array
          items:
            type: string
        revokeBy:
          type: string
          description: Unix time (ms) when suppression expires; omit for no expiry.
      required:
        - suppressionID
        - operator
        - values
      description: Exclude systems/recommendations from the output.
    ReturnStructure:
      type: object
      properties:
        showAliases:
          type: boolean
          default: false
          description: Use field aliases as element keys when true.
        fields:
          type: array
          items:
            type: string
          description: Fields to include in returned dataset.
    Schedule:
      type: object
      properties:
        frequency:
          type: string
          description: Implementation-defined frequency (e.g., NIGHTLY, WEEKLY).
        at:
          type: string
          description: HH:mm (24h) time string for trigger.
      description: >-
        If omitted, notifications typically trigger nightly after
        analysis/reporting.

````