events.incidents.update

Resource information

URLhttps://api.statscore.com/v2/events/{event_id}/incidents/{incidnet_id}
MethodPATCH

Description

Updates incident for event.
Authorization requiredYes
Internal methodYes

Parameters 

NameData typeDescription
event_idxsd:intREQUIRED. The event identifier
tokenxsd:stringREQUIRED. More information concerning authorization in API introduction section
incident_idxsd:intREQUIRED. The incident identifier.
incidentxsd:arrayREQUIRED. Array with incident parameters
incident[participant_id]xsd:intParticipant id
incident[participant_team_id]xsd:intParticipant team id
incident[participant_name]xsd:stringParticipant name.
incident[minute]xsd:intIncident time minute
incident[second]xsd:intIncident time second
incident[home_score]xsd:intHome Score
incident[away_score]xsd:intAway Score
incident[home_score1]xsd:intHome Score 1
incident[away_score1]xsd:intAway Score 1
incident[home_score2]xsd:intHome Score 2
incident[away_score2]xsd:intAway Score 2
incident[x_pos]
xsd:intBall position on X axis (percents)
incident[y_pos]
xsd:intBall position on Y axis (percents)
incident[add_data]xsd:stringCustom information
incident[display_info]xsd:stringLabel for incidents
incident[old_added_id]xsd:intDEPRECATED. Old Id

Output elements

.data

messageResponse info message.
statusResponse code.
..incident
idUnique identifier for the incident 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.
participant_idUnique identifier of participant (player, team or coach) name related to incident 
participant_nameParticipants (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 dont use this attribute
important_for_trader

Possible values:

  • yes
  • no
importantInternal attribute, please dont use this attribute
add_dataInternal attribute, please dont use this attribute
show_popupInternal attribute, please dont use this attribute
show_scoresInternal attribute, please dont use this attribute
show_actionInternal attribute, please dont use this attribute
show_timeInternal attribute, please dont use this attribute
show_on_timelineInternal attribute, please dont use this attribute
event_timeInformation when the incident occurs in format MM:SS
event_status_idUnique identifier of the event status
event_status_nameName of the event status
x_posBall position on X axis (percents)
y_posBall position on Y axis (percents)
...participant
idUnique identifier for the participant
type

Participant type. Possible values:

  • team
  • person
nameParticipant name
short_nameParticipants abbreviated name, max length: 20 characters
acronymMax 3 characters in length mini name, e.g. BAR, REA
gender

Participant gender. Possible value:

  • male
  • female
  • mixed (e.g for doubles in tennis)
area_idUnique identifier for the area represented by the participant 
area_nameArea name represented by the participant
area_codeMax 3 characters in length of the abbreviated area name e.g. GER, POL, FRA
sport_idUnique identifier for the sport in which the participant takes part 
sport_nameName of the sport in which the participant takes part
national

Determines if the participant is national team. Possible values:

  • yes
  • no
websiteParticipants official website
utInformation about the date and time of when the record was last updated. Format UNIX_TIMESTAMP
old_participant_iddeprecated. The attribute will be removed in next API version
slugfriendly url for participant
logoAttribute for internal purposes
foundedDate when the team was founded
phonePhone number
emailEmail address
addressAddress where the team is located
venue_idUnique identifier for the venue in which the team plays home games
venue_nameName of the venue in which the team plays home games
weightParticipants weight
heightParticipants height
nicknameParticipants nickname
position_nameName of the participants position
birthdateParticipants date of birth
born_placeParticipants place of birth
is_retired

Determines if participant has retired. Possible values:

  • yes
  • no
subtype

Participant subtype name. Possible values:

  • athlete
  • coach
  • referee
  • director
..eventnode available only if message type is 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
nameThe name of the event
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 of the event status 
sport_idIdentifier for the sport in which the event is played 
round_idUnique identifier for the round in which event is played. Possible null value  
round_nameName of the round. Possible null value.
dayDay of the season
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 
season_idUnique identifier for the season.
stage_idUnique identifier for the stage
tour_idUnique identifier for the tour in which a competition is played
gender

Competition gender. Possible values:

  • male
  • female
  • mixed
bet_status

Bet 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 the status. Possible values:

  • live
  • scheduled
  • finished
  • cancelled
  • interrupted
  • deleted
  • other
...details
....detail
idUnique identifier for the detail. Possible values are different depending on the sport
valueValue related to the detail
....participants
.....participant
counterNumber of participant in the event. Participant with counter="1" is the home team, "2" is the away team
idUnique identifier of the participant 
nameParticipants name
short_nameParticipants abbreviated name, max length: 20 characters
acronymMax 3 characters in length mini name, e.g. BAR, REA
area_idUnique identifier for the area represented by the participant 
area_nameArea name represented by the participant
area_codeMax 3 characters in length for 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
......results
.......result
idUnique identifier for the result. Possible values are different depending on the sport
valueValue related to the results
......stats
.......stat
idUnique identifier for the statistic. Possible values are different depending on the sport
valueValue related to the statistic
......subparticipants

.......subparticipant

idUnique identifier of the participant
counterNumber of subparticipant in the event
nameParticipants name
short_nameParticipants abbreviated name, max length: 20 characters
acronymMax 3 characters in length mini name, e.g. BAR, REA
area_idUnique identifier for the area represented by the participant 
area_nameArea name represented by the participant
area_codeMax 3 characters in length for 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
........results
.........result
idUnique identifier for the result
valueValue related to the result
........stats
.........stat
idUnique identifier for the statistic
valueValue related to the statistic


Sample curl call

Request
 Parameters
curl -XPUT 'https://api.statscore.com/v2/events/{event_id}/incidents/{id}?token={token}''

event_id, id, token



Output elements

.data

messageResponse info message.
statusResponse code.
..incident
idUnique identifier for the incident 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.
participant_idUnique identifier of participant (player, team or coach) name related to incident 
participant_nameParticipants (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 dont use this attribute
important_for_trader

Possible values:

  • yes
  • no
importantInternal attribute, please dont use this attribute
add_dataInternal attribute, please dont use this attribute
show_popupInternal attribute, please dont use this attribute
show_scoresInternal attribute, please dont use this attribute
show_actionInternal attribute, please dont use this attribute
show_timeInternal attribute, please dont use this attribute
show_on_timelineInternal attribute, please dont use this attribute
event_timeInformation when the incident occurs in format MM:SS
event_status_idUnique identifier of the event status
event_status_nameName of the event status
x_posBall position on X axis (percents)
y_posBall position on Y axis (percents)
...participant
idUnique identifier for the participant
type

Participant type. Possible values:

  • team
  • person
nameParticipant name
short_nameParticipants abbreviated name, max length: 20 characters
acronymMax 3 characters in length mini name, e.g. BAR, REA
gender

Participant gender. Possible value:

  • male
  • female
  • mixed (e.g for doubles in tennis)
area_idUnique identifier for the area represented by the participant 
area_nameArea name represented by the participant
area_codeMax 3 characters in length of the abbreviated area name e.g. GER, POL, FRA
sport_idUnique identifier for the sport in which the participant takes part 
sport_nameName of the sport in which the participant takes part
national

Determines if the participant is national team. Possible values:

  • yes
  • no
websiteParticipants official website
utInformation about the date and time of when the record was last updated. Format UNIX_TIMESTAMP
old_participant_iddeprecated. The attribute will be removed in next API version
slugfriendly url for participant
logoAttribute for internal purposes
foundedDate when the team was founded
phonePhone number
emailEmail address
addressAddress where the team is located
venue_idUnique identifier for the venue in which the team plays home games
venue_nameName of the venue in which the team plays home games
weightParticipants weight
heightParticipants height
nicknameParticipants nickname
position_nameName of the participants position
birthdateParticipants date of birth
born_placeParticipants place of birth
is_retired

Determines if participant has retired. Possible values:

  • yes
  • no
subtype

Participant subtype name. Possible values:

  • athlete
  • coach
  • referee
  • director
..eventnode available only if message type is 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
nameThe name of the event
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 of the event status 
sport_idIdentifier for the sport in which the event is played 
round_idUnique identifier for the round in which event is played. Possible null value  
round_nameName of the round. Possible null value.
dayDay of the season
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 
season_idUnique identifier for the season.
stage_idUnique identifier for the stage
tour_idUnique identifier for the tour in which a competition is played
gender

Competition gender. Possible values:

  • male
  • female
  • mixed
bet_status

Bet 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 the status. Possible values:

  • live
  • scheduled
  • finished
  • cancelled
  • interrupted
  • deleted
  • other
...details
....detail
idUnique identifier for the detail. Possible values are different depending on the sport
valueValue related to the detail
....participants
.....participant
counterNumber of participant in the event. Participant with counter="1" is the home team, "2" is the away team
idUnique identifier of the participant 
nameParticipants name
short_nameParticipants abbreviated name, max length: 20 characters
acronymMax 3 characters in length mini name, e.g. BAR, REA
area_idUnique identifier for the area represented by the participant 
area_nameArea name represented by the participant
area_codeMax 3 characters in length for 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
......results
.......result
idUnique identifier for the result. Possible values are different depending on the sport
valueValue related to the results
......stats
.......stat
idUnique identifier for the statistic. Possible values are different depending on the sport
valueValue related to the statistic
......subparticipants

.......subparticipant

idUnique identifier of the participant
counterNumber of subparticipant in the event
nameParticipants name
short_nameParticipants abbreviated name, max length: 20 characters
acronymMax 3 characters in length mini name, e.g. BAR, REA
area_idUnique identifier for the area represented by the participant 
area_nameArea name represented by the participant
area_codeMax 3 characters in length for 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
........results
.........result
idUnique identifier for the result
valueValue related to the result
........stats
.........stat
idUnique identifier for the statistic
valueValue related to the statistic