Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 47 Next »

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.

Message example:

Structure - incident
{
  "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",
      "game_break": "no",
      "x_pos": null,
      "y_pos": null,
      "ct": 1611574377,
      "ut": 1611574412
    },
    "event": {
      "id": 3755129,
      "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,
      "group_id": null,
      "tour_id": 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",
      "event_stats_lvl": "gold",
      "verified_result": "no",
      "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
idUnique identifier for the message
uuidUniversally unique identifier
type

incident

sourceInternal attribute, please don't use this attribute
utInformation about the date and time of when the message was created. Format UNIX_TIMESTAMP
..data
...incident
idUnique 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_idIdentifier for the incident
incident_nameName of the incident. e.g. goal, yellow card, red card etc.
attribute_idsAttributes identifiers related to incident, separated by a comma (e.g. [397, 398])
additional_infoContains 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_idUnique identifier for the participant (player, team or coach) name related to incident 
participant_nameParticipant's (player, team or coach) name related to incident.  
subparticipant_idTeam id that the player or coach is part of 
subparticipant_nameTeam name that the player or coach is part of
infoInternal attribute, please don't use this attribute
importantInternal attribute, please don't use this attribute
important_for_trader

Possible values:

  • yes
  • no
add_dataInternal attribute, please don't use this attribute
show_popupInternal attribute, please don't use this attribute
show_scoresInternal attribute, please don't use this attribute
show_actionInternal attribute, please don't use this attribute
show_timeInternal attribute, please don't use this attribute
show_on_timelineInternal attribute, please don't use this attribute
event_timeInformation when the incident occurs in format MM:SS
event_status_idUnique identifier for the event status 
event_status_nameName of the event status
x_posBall position on X axis (percentage value from 0 to 100)
y_posBall position on Y axis (percentage value from 0 to 100)
ctInformation about the date and time when the incident was created. Format UNIX_TIMESTAMP
utInformation about the date and time when the incident was updated. Format UNIX_TIMESTAMP
...event
idIdentifier of the event
action

Describes type of operation for the event. Possible values:

  • insert - new event generated
  • update - event was updated
  • delete - event was deleted
start_dateStart 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_idUnique identifier for the event status. The list of available statuses can be found in the API service method: statuses.index
sport_idIdentifier for the sport in which the event is played. The list of available sports can be found in the API service method: sports.index
dayDay 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_timeNumber of seconds that have passed in the current period
clock_status

Clock status. Possible value:

  • running
  • stopped
area_idIdentifier for the area in which the competitions are played
competition_idUnique identifier for the competition. The list of available competitions can be found in the API service method: competitions.index
season_idUnique identifier for the season.
stage_idUnique identifier for the stage
tour_idUnique 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
nameName of the event
round_idThe list of available rounds can be found in the API service method: rounds.index. Possible null value
round_nameName 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_resultInforms that the result has been verified by an internal unit. Possible values:
  • yes
  • no
.....details
idUnique identifier for the event details e.g: 1st quarter start time, length of the period. Possible values are different depending on the sport. 
valueValue related to the event detail
.....participantsOnly last changed participant will be sent in the message.
idUnique identifier of the participant. The list of available participants can be found in the API service method: participants.index
counterNumber of participant in the event. Participant with counter="1" is the home team, "2" is the away team
nameParticipant name
short_nameParticipants abbreviated name, max length: 20 characters
acronymMax 3 characters in length mini name, e.g. BAR, REA
area_idDetermines the area represented by the participant. The complete list of possible areas can be retrieved using the API resource: areas.index
area_nameArea name represented by the participant
area_codeMax 3 characters in length of the abbreviated area name e.g. GER, POL, FRA
utInformation 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
idUnique 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 
valueValue related to the results
......stats
idUnique 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
valueValue related to the statistic



  • No labels