Kick.GiftSubscription

WebSocket event schema, payload, and examples

Properties

isAnonymous
boolean required
user
object required
recipient
object required
subscribedAt
string required
expiresAt
string required
isTest
boolean required

Schema

The JSON Schema for the event payload, if available.
schema.json
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "title": "KickGiftSubscriptionEvent",
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "isAnonymous": {
      "type": "boolean"
    },
    "user": {
      "oneOf": [
        {
          "type": "null"
        },
        {
          "$ref": "#/definitions/KickBaseUser"
        }
      ]
    },
    "recipient": {
      "oneOf": [
        {
          "type": "null"
        },
        {
          "$ref": "#/definitions/KickBaseUser"
        }
      ]
    },
    "subscribedAt": {
      "type": "string",
      "format": "date-time"
    },
    "expiresAt": {
      "type": "string",
      "format": "date-time"
    },
    "isTest": {
      "type": "boolean"
    }
  },
  "definitions": {
    "KickBaseUser": {
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "id": {
          "type": [
            "null",
            "string"
          ]
        },
        "login": {
          "type": [
            "null",
            "string"
          ]
        },
        "name": {
          "type": [
            "null",
            "string"
          ]
        },
        "type": {
          "type": [
            "null",
            "string"
          ]
        },
        "profilePicture": {
          "type": [
            "null",
            "string"
          ]
        },
        "role": {
          "$ref": "#/definitions/ViewerRole"
        },
        "isSubscribed": {
          "type": "boolean"
        }
      }
    },
    "ViewerRole": {
      "type": "integer",
      "description": "",
      "x-enum-names": [
        "Unknown",
        "Viewer",
        "Vip",
        "Moderator",
        "Broadcaster"
      ],
      "x-enum-varnames": [
        "Unknown",
        "Viewer",
        "Vip",
        "Moderator",
        "Broadcaster"
      ],
      "x-enumNames": [
        "Unknown",
        "Viewer",
        "Vip",
        "Moderator",
        "Broadcaster"
      ],
      "x-enum-descriptions": [
        null,
        null,
        null,
        null,
        null
      ],
      "x-enumDescriptions": [
        null,
        null,
        null,
        null,
        null
      ],
      "enum": [
        0,
        1,
        2,
        3,
        4
      ]
    }
  }
}

JSON Payload

An example JSON payload for the event, automatically generated using JSONSchemaFaker
example.json
{
  "expiresAt": "1927-03-24T09:14:29.0Z",
  "isAnonymous": false,
  "isTest": true,
  "recipient": {
    "id": "id in anim",
    "isSubscribed": false,
    "login": null,
    "name": null,
    "profilePicture": null,
    "role": 3,
    "type": "ex"
  },
  "subscribedAt": "1939-10-16T02:45:13.0Z",
  "user": {
    "id": null,
    "isSubscribed": true,
    "login": "voluptate officia nostrud",
    "name": "et ut do incididunt",
    "profilePicture": null,
    "role": 1,
    "type": null
  }
}

Client Example

Example code showing how to subscribe to this event using the Streamer.bot WebSocket Client
index.js
// Initialize the Streamer.bot WebSocket Client
const client = new StreamerbotClient();

// Subscribe to "Kick.GiftSubscription" events and register a callback
client.on('Kick.GiftSubscription', ({ event, data }) => {
  // Code here will run every time the event is received!
  console.log('Received event:', event.source, event.type);
  console.log('Event data:', data);
});