# Incident Kinds Types

## Overview

The Incidents Queue delivers messages categorized by **Kind**. Each Kind represents a different type of event and has its own message structure and timing rules.

All incident messages share common fields (MessageId, Timestamp, Fixture, Decision Info, etc.) but each Kind has unique conditional fields that define its specific behavior.

***

## Kinds Summary

| Kind                   | Description                                                                                                                                                               |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Score**              | Reports score changes when a scoring event occurs (goal, point, run, etc.). Each period starts at 0-0 and position IDs remain constant throughout the match.              |
| **Period**             | Reports period state changes when a period starts (Status = "Started") or ends (Status = "Finished") for halves, quarters, sets, etc.                                     |
| **Statistic**          | Reports in-game team statistics such as corners, yellow cards, attacks, shots, fouls, and offsides. Updates continuously as statistics change during the match.           |
| **Player Statistic**   | Reports individual player statistics such as shots on target, tackles, passes, and goals. Sent when player-specific events occur and accumulates throughout the match.    |
| **VAR**                | Reports Video Assistant Referee review processes and decisions. Sent when VAR review begins or when a VAR decision is made.                                               |
| **Timer**              | Reports match clock and timing events. Sent periodically during the match and on timing events like stoppage time or injury time.                                         |
| **Possession**         | Reports ball possession percentage for each team. Updates continuously during the match, typically every few seconds. Match-wide statistic with no period breakdown.      |
| **Status Description** | Reports fixture-level status changes that are not tied to specific game events. Provides period-specific status updates.                                                  |
| **Fixture Status**     | Reports overall fixture status changes such as NSY, In Progress, Finished, Cancelled, Postponed, Interrupted, Abandoned, AboutToStart, etc. Status codes range from 0–10. |

***

## Core Incident Kinds

### 1. Score

**Purpose:** Reports score changes during the match.

**When sent:**

* Immediately when a scoring event occurs (goal, point, run, etc.)
* Each period starts at 0-0 and reports independently
* Position IDs remain constant throughout the match (Position 1 = Home, Position 2 = Away)
* Each period score resets to 0-0 (e.g. 1st Half: 0-0 → 2nd Half: 0-0)

***

### 2. Period

**Purpose:** Reports period state changes (start/end of halves, quarters, sets, etc.)

**When sent:**

* When a period starts (Status = "Started")
* When a period ends (Status = "Finished")

***

### 3. Statistic

**Purpose:** Reports in-game statistics (corners, yellow cards, attacks, shots, etc.)

**When sent:**

* Continuously throughout the match as statistics change
* Frequency varies by statistic type

***

### 4. Player Statistic

**Purpose:** Reports individual player statistics.

**When sent:**

* When player-specific events occur
* Accumulates throughout the match

***

### 5. VAR

**Purpose:** Reports VAR review processes and decisions.

**When sent:**

* When VAR review begins
* When VAR decision is made

***

### 6. Timer

**Purpose:** Reports match clock and timing events.

**When sent:**

* Periodically during the match
* On timing events (stoppage time, injury time, etc.)

***

### 7. Possession

**Purpose:** Reports ball possession percentage.

**When sent:**

* Continuously updates during match, typically every few seconds

***

### 8. Status Description

**Purpose:** Reports fixture-level status changes not tied to specific game events.

**When sent:**

* When overall match status changes

***

### 9. Fixture Status

**Purpose:** Reports overall fixture status changes.

**When sent:**

* When match status changes (NSY, InProgress, Finished, Cancelled, etc.)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.lsports.eu/u/engage/hyper-livescore/incident-kinds-types.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.