Message: incident

This type of message is sent when an incident occurs during the event/match that is running.
The message includes information concerning the last incident and ALL event details (results, statistics) are updated in real time.
Available in the ScoutsFeed product only.

Message example:

{
  "id": 412288074,
  "uuid": "bac94ae5-271c-40ec-a15b-47a9b3247da3",
  "type": "incident",
  "source": 1148,
  "ut": 1611574413,
  "data": {
    "incident": {
      "id": "5-136603024",
      "action": "update",
      "incident_id": 413,
      "incident_name": "Goal",
      "attribute_ids": [
        398
      ],
      "additional_info": [],
      "confirmation": "tbd",
      "participant_id": 136935,
      "participant_name": "Real Valladolid",
      "subparticipant_id": 319261,
      "subparticipant_name": "Raul Garcia",
      "info": null,
      "important": "yes",
      "important_for_trader": "yes",
      "add_data": null,
      "show_popup": "yes",
      "show_scores": "no",
      "show_action": "yes",
      "show_time": "yes",
      "show_on_timeline": "yes",
      "event_time": "02:25",
      "event_status_id": 33,
      "event_status_name": "1st half",
      "period_timer": {
        "direction": "down",
        "time": "00:06:47"
      },
      "game_break": "no",
      "x_pos": null,
      "y_pos": null,
      "ct": 1611574377,
      "ut": 1611574412
      "confirmation_time": "2024-02-28 13:46:22"
    },
    "event": {
      "id": 3755129,
      "ls_id": "3660304"
      "action": "update",
      "start_date": "2021-01-02 17:30",
      "ft_only": "no",
      "coverage_type": "from_tv",
      "status_id": 33,
      "sport_id": 5,
      "day": 17,
      "neutral_venue": "no",
      "item_status": "active",
      "clock_time": 182,
      "clock_status": "running",
      "area_id": 70,
      "competition_id": 1507,
      "season_id": 46446,
      "stage_id": 108896,
      "stage_name": "Regular season",
      "group_id": null,
      "tour_id": null,
      "tour_name": null,
      "gender": "male",
      "bet_status": "suspended",
      "bet_cards": "suspended",
      "bet_corners": "suspended",
      "relation_status": "not_started",
      "status_type": "live",
      "name": "Getafe CF - Real Valladolid",
      "round_id": 17,
      "round_name": "Round 17",
      "scoutsfeed": "yes",
      "latency":"3-6s",
      "event_stats_lvl": "gold",
      "event_stats_lvl_live": "gold",
      "event_stats_lvl_after": "gold",
      "verified_result": "no",
      "is_coverage_limited": "no",
      "played_time": null,
      "details": [
        {
          "id": 8,
          "value": null
        },
        {
          "id": 19,
          "value": "2021-01-25 11:30"
        },
        {
          "id": 58,
          "value": "No Extra Time"
        },
        {
          "id": 227,
          "value": null
        }
      ],
      "participants": [
        {
          "id": 136929,
          "counter": 1,
          "name": "Getafe Club de Futbol, S.A.D.",
          "short_name": "Getafe CF",
          "acronym": "GET",
          "area_id": 70,
          "area_name": "Spain",
          "area_code": "ESP",
          "ut": 1602906642,
          "type": "team",
          "stats": [
            {
              "id": 8,
              "value": 0
            },
            {
              "id": 716,
              "value": null
            },
            {
              "id": 777,
              "value": 0
            }
          ],
          "results": [
            {
              "id": 2,
              "value": 0
            },
            {
              "id": 412,
              "value": 0
            }
          ],
          "subparticipants": []
        },
        {
          "id": 136935,
          "counter": 2,
          "name": "Real Valladolid Club de Futbol, S.A.D.",
          "short_name": "Real Valladolid",
          "acronym": "VAL",
          "area_id": 70,
          "area_name": "Spain",
          "area_code": "ESP",
          "ut": 1477213104,
          "type": "team",
          "stats": [
            {
              "id": 8,
              "value": 0
            },
            {
              "id": 716,
              "value": null
            },
            {
              "id": 777,
              "value": 0
            }
          ],
          "results": [
            {
              "id": 2,
              "value": 1
            },
            {
              "id": 412,
              "value": 0
            }
          ],
          "subparticipants": []
        }
      ]
    }
  }
}

Message structure details:

.message
id	Unique identifier for the message
uuid	Universally Unique Identifier for the massage. Note: for certain messages, such as updates to a previous, related message, the UUID may be the same. This intentional duplication allows clients to establish correlations between messages, aiding in tracking updates or related data across a system.
type	incident
source	Internal attribute, please don't use this attribute
ut	Information about the date and time of when the message was created. Format UNIX_TIMESTAMP
..data
...incident
id	Unique identifier for the incident that occurred in the event
action	Describes type of scout operation for the incident. Possible values: insert - new incident generated by the scout update - incident was updated by the scout (e.g. incident "yellow card" is updated when scout fills in the name of the player (participant) delete - incident was deleted (e.g. when the scout adds an incident by mistake, he can delete it)
incident_id	Identifier for the incident
incident_name	Name of the incident. e.g. goal, yellow card, red card etc.
attribute_ids	Attributes identifiers related to incident, separated by a comma (e.g. [397, 398])
additional_info	Contains additional information, e.g. goalkeeper_id, assistant_id (assistant_id = 12345)
confirmation	Describes confirmation status for the incident. Possible values: tbd – appears as default for Goal, Penalty, Red card, Yellow card and Corner incidents. confirmed – appears when the following incident will be confirmed by referee. cancelled – appears when the following incident will be cancelled by referee. Incidents with this value have no effect on statistics.
participant_id	Unique identifier for the participant (player, team or coach) name related to incident
participant_name	Participant's (player, team or coach) name related to incident.
subparticipant_id	Team id that the player or coach is part of
subparticipant_name	Team name that the player or coach is part of
info	Internal attribute, please don't use this attribute
important	Internal attribute, please don't use this attribute
important_for_trader	Possible values: yes no
add_data	Internal attribute, please don't use this attribute
show_popup	Internal attribute, please don't use this attribute
show_scores	Internal attribute, please don't use this attribute
show_action	Internal attribute, please don't use this attribute
show_time	Internal attribute, please don't use this attribute
show_on_timeline	Internal attribute, please don't use this attribute
event_time	Information when the incident occurs in format MM:SS
event_status_id	Unique identifier for the event status
event_status_name	Name of the event status
period_timer	Informations regarding game clock
direction	Contains information about timer direction. Possible values: down up
time	Time in sync with the game clock
x_pos	Ball position on X axis (percentage value from 0 to 100)
y_pos	Ball position on Y axis (percentage value from 0 to 100)
ct	Information about the date and time when the incident was created. Format UNIX_TIMESTAMP
ut	Information about the date and time when the incident was updated. Format UNIX_TIMESTAMP
...event
id	Identifier of the event
ls_id	For internal purposes
action	Describes type of operation for the event. Possible values: insert - new event generated update - event was updated delete - event was deleted
start_date	Start date for the event in format: YYYY-MM-DD hh:mm
ft_only	Determines if only the full time result/score of the event is given . Possible values: yes - result/score is updated only when the event is finished no - result/score is updated during the event
coverage_type	Type of event coverage. Possible values: from_venue - means the scout is relaying the event directly from the stadium (max. latency 1 second) from_low_latency_tv - means the scout is relaying the event from TV transmission (max. latency 3 seconds) from_tv - means the scout is relaying the event from TV transmission (max. latency 8 seconds) basic - for this type of coverage we don't provide detailed event incidents (max. latency around 60 seconds)
status_id	Unique identifier for the event status. The list of available statuses can be found in the API service method: statuses.index
sport_id	Identifier for the sport in which the event is played. The list of available sports can be found in the API service method: sports.index
day	Day of the season. This attribute is deprecated and will no longer used
neutral_venue	Determines if event is played at a neutral venue. Possible values: yes no
item_status	Describes status for the item (record). Possible values: active - the record is active deleted - the record was deleted by the admin. In the case of when an event was added by mistake
clock_time	Number of seconds that have passed in the current period
clock_status	Clock status. Possible value: running stopped
area_id	Identifier for the area in which the competitions are played
competition_id	Unique identifier for the competition. The list of available competitions can be found in the API service method: competitions.index
season_id	Unique identifier for the season.
stage_id	Unique identifier for the stage
tour_id	Unique identifier for the tour in which a competition is played. The list of available competitions can be found in the API service method: tours.index
gender	Competition gender. Possible values: male female mixed
bet_status	Bet status. Possible values: active suspended
bet_cards	Booking market status. Possible values: active suspended
bet_corners	Corners market status. Possible values: active suspended
relation_status	Relation status. Attribute for internal purposes. Possible value: not_started - for an event that has not started in_progress - for a live event finished - for an event that has finished 30_min_left - scout confirms his ability to deliver the coverage 30 min before the event 5_min_left - scout confirms his ability to deliver the coverage 5 min before the event
status_type	Type of status. Possible values: live scheduled finished cancelled interrupted deleted other
name	Name of the event
round_id	The list of available rounds can be found in the API service method: rounds.index. Possible null value
round_name	Name of the round. Possible null value
scoutsfeed	Informs about availability in the Scoutsfeed product. Possible values: yes no
event_stats_lvl	Informs about statistics level for this event. Possible values: bronze silver gold vip
verified_result	Informs that the result has been verified by an internal unit. Possible values: yes no
is_coverage_limited	Determines if event has limited information about players statistics
played_time	Number of seconds passed in the current period, including additional time
.....details
id	Unique identifier for the event details e.g: 1st quarter start time, length of the period. Possible values are different depending on the sport.
value	Value related to the event detail
.....participants	Only last changed participant will be sent in the message.
id	Unique identifier of the participant. The list of available participants can be found in the API service method: participants.index
counter	Number of participant in the event. Participant with counter="1" is the home team, "2" is the away team
name	Participant name
short_name	Participants abbreviated name, max length: 20 characters
acronym	Max 3 characters in length mini name, e.g. BAR, REA
area_id	Determines the area represented by the participant. The complete list of possible areas can be retrieved using the API resource: areas.index
area_name	Area name represented by the participant
area_code	Max 3 characters in length of the abbreviated area name e.g. GER, POL, FRA
ut	Information about the date and time of when the record was last updated. Format UNIX_TIMESTAMP
type	Informs about the type of participant. Possible values: person team double
......results
id	Unique identifier for the result. Possible values are different depending on the sport. For more information please find node details in the sports.show API method
value	Value related to the results
......stats
id	Unique identifier for the statistic. Possible values are different depending on the sport. For more information please find node details in the sports.show API method
value	Value related to the statistic