# getSubscriptionInformation

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /json-rpc/system/subscriptions:
    post:
      summary: getSubscriptionInformation
      deprecated: false
      description: >-
        Query about active and available subscriptions which where set by
        [setSubscriptions](https://api.hyperion-project.org/setsubscriptions-17016242e0.md)
      tags:
        - Hyperion API/Information
        - Websocket
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                command:
                  type: string
                  description: The type of command to execute.
                  title: ''
                  enum:
                    - serverinfo
                  x-apidog-enum:
                    - value: serverinfo
                      name: ''
                      description: ''
                subcommand:
                  type: string
                  description: The type of sub-command to execute.
                  title: ''
                  enum:
                    - getSubscriptions
                    - getSubscriptionCommands
                  x-apidog-enum:
                    - value: getSubscriptions
                      name: ''
                      description: ''
                    - value: getSubscriptionCommands
                      name: ''
                      description: ''
                instance:
                  description: Instance index (0-254) to which the command applies.
                  $ref: '#/components/schemas/instance%20-%20single'
                tan:
                  type: integer
                  minimum: 0
                  examples:
                    - 4711
                  description: Transaction number for tracking requests and responses.
              x-apidog-orders:
                - command
                - subcommand
                - instance
                - 01JVHARBC5KH9YQ6YNQ1TTGE9W
              required:
                - command
                - subcommand
              x-apidog-refs:
                01JVHARBC5KH9YQ6YNQ1TTGE9W:
                  $ref: '#/components/schemas/tan'
              x-apidog-ignore-properties:
                - tan
            examples:
              '1':
                value:
                  command: serverinfo
                  subcommand: getSubscriptions
                  instance: 0
                  tan: 4711
                summary: Active Subscriptions
                description: Get all active subscriptions for instance 0.
              '2':
                value:
                  command: serverinfo
                  subcommand: getSubscriptionCommands
                  tan: 4711
                summary: All Subscription Commands
                description: Get a list of all commands subscriptions can be requested for.
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  command:
                    type: string
                    description: The command executed
                  subcommand:
                    type: string
                    description: The sub-command executed
                  success:
                    type: boolean
                    description: Result, if the request excuted successfully
                  info:
                    type: object
                    properties: {}
                    x-apidog-orders: []
                    description: Information requested
                    additionalProperties: true
                    x-apidog-ignore-properties: []
                  error:
                    type: string
                    description: Reason why a request did not execute successfully
                  errorData:
                    type: array
                    items:
                      type: object
                      properties:
                        description:
                          type: string
                      x-apidog-orders:
                        - description
                      x-apidog-ignore-properties: []
                    description: Detailed error explaination
                  tan:
                    type: integer
                    description: Request's transaction number
                x-apidog-orders:
                  - 01JV5M76DZ4M3GA4AD8Y4G69AP
                required:
                  - command
                  - success
                  - tan
                x-apidog-refs:
                  01JV5M76DZ4M3GA4AD8Y4G69AP:
                    $ref: '#/components/schemas/response'
                x-apidog-ignore-properties:
                  - command
                  - subcommand
                  - success
                  - info
                  - error
                  - errorData
                  - tan
              examples:
                '1':
                  summary: ''
                  value:
                    command: serverinfo-getSubscriptions
                    info:
                      subscriptions:
                        - components-update
                    success: true
                    tan: 4711
                '2':
                  summary: ''
                  value:
                    command: serverinfo-getSubscriptionCommands
                    info:
                      commands:
                        - adjustment-update
                        - components-update
                        - effects-update
                        - event-update
                        - imageToLedMapping-update
                        - instance-update
                        - ledcolors-imagestream-update
                        - ledcolors-ledstream-update
                        - leds-update
                        - logmsg-update
                        - priorities-update
                        - settings-update
                        - token-update
                        - videomode-update
                    success: true
                    tan: 4711
          headers: {}
          x-apidog-name: Success
      security: []
      x-apidog-folder: Hyperion API/Information
      x-apidog-status: released
      x-run-in-apidog: https://app.apidog.com/web/project/894413/apis/api-17016059-run
components:
  schemas:
    instance - single:
      type: integer
      minimum: 0
      maximum: 254
      description: Instance index (0-254) to which the command applies.
      x-apidog-folder: ''
    tan:
      type: object
      properties:
        tan:
          type: integer
          minimum: 0
          examples:
            - 4711
          description: Transaction number for tracking requests and responses.
      x-apidog-orders:
        - tan
      title: tan
      x-apidog-folder: ''
      x-apidog-ignore-properties: []
    response:
      type: object
      properties:
        command:
          type: string
          description: The command executed
        subcommand:
          type: string
          description: The sub-command executed
        success:
          type: boolean
          description: Result, if the request excuted successfully
        info:
          type: object
          properties: {}
          x-apidog-orders: []
          description: Information requested
          additionalProperties: true
          x-apidog-ignore-properties: []
        error:
          type: string
          description: Reason why a request did not execute successfully
        errorData:
          type: array
          items:
            type: object
            properties:
              description:
                type: string
            x-apidog-orders:
              - description
            x-apidog-ignore-properties: []
          description: Detailed error explaination
        tan:
          type: integer
          description: Request's transaction number
      required:
        - command
        - success
        - tan
      x-apidog-orders:
        - command
        - subcommand
        - success
        - info
        - error
        - errorData
        - tan
      x-apidog-folder: ''
      x-apidog-ignore-properties: []
  securitySchemes: {}
servers:
  - url: http://{{host}}:8090
    description: Develop Env
  - url: https://{{host}}:8092
    description: Testing Env
security: []

```