events.incidents.update

Resource information

URL	https://api.statscore.com/v2/events/{event_id}/incidents/{incidnet_id}
Method	PATCH
Description	Updates incident for event.
Authorization required	Yes
Internal method	Yes

Parameters

Name	Data type	Description
event_id	xsd:int	REQUIRED. The event identifier
token	xsd:string	REQUIRED. More information concerning authorization in API introduction section
incident_id	xsd:int	REQUIRED. The incident identifier.
incident	xsd:array	REQUIRED. Array with incident parameters
incident[participant_id]	xsd:int	Participant id
incident[participant_team_id]	xsd:int	Participant team id
incident[participant_name]	xsd:string	Participant name.
incident[minute]	xsd:int	Incident time minute
incident[second]	xsd:int	Incident time second
incident[home_score]	xsd:int	Home Score
incident[away_score]	xsd:int	Away Score
incident[home_score1]	xsd:int	Home Score 1
incident[away_score1]	xsd:int	Away Score 1
incident[home_score2]	xsd:int	Home Score 2
incident[away_score2]	xsd:int	Away Score 2
incident[x_pos]	xsd:int	Ball position on X axis (percents)
incident[y_pos]	xsd:int	Ball position on Y axis (percents)
incident[add_data]	xsd:string	Custom information
incident[display_info]	xsd:string	Label for incidents
incident[old_added_id]	xsd:int	DEPRECATED. Old Id

Output elements

.data
message	Response info message.
status	Response code.
..incident
id	Unique 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_id	Identifier for the incident
incident_name	Name of the incident. e.g. goal, yellow card, red card etc.
participant_id	Unique identifier of participant (player, team or coach) name related to incident
participant_name	Participants (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 dont use this attribute
important_for_trader	Possible values: yes no
important	Internal attribute, please dont use this attribute
add_data	Internal attribute, please dont use this attribute
show_popup	Internal attribute, please dont use this attribute
show_scores	Internal attribute, please dont use this attribute
show_action	Internal attribute, please dont use this attribute
show_time	Internal attribute, please dont use this attribute
show_on_timeline	Internal attribute, please dont use this attribute
event_time	Information when the incident occurs in format MM:SS
event_status_id	Unique identifier of the event status
event_status_name	Name of the event status
x_pos	Ball position on X axis (percents)
y_pos	Ball position on Y axis (percents)
...participant
id	Unique identifier for the participant
type	Participant type. Possible values: team person
name	Participant name
short_name	Participants abbreviated name, max length: 20 characters
acronym	Max 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_id	Unique identifier for the area represented by the participant
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
sport_id	Unique identifier for the sport in which the participant takes part
sport_name	Name of the sport in which the participant takes part
national	Determines if the participant is national team. Possible values: yes no
website	Participants official website
ut	Information about the date and time of when the record was last updated. Format UNIX_TIMESTAMP
old_participant_id	deprecated. The attribute will be removed in next API version
slug	friendly url for participant
logo	Attribute for internal purposes
founded	Date when the team was founded
phone	Phone number
email	Email address
address	Address where the team is located
venue_id	Unique identifier for the venue in which the team plays home games
venue_name	Name of the venue in which the team plays home games
weight	Participants weight
height	Participants height
nickname	Participants nickname
position_name	Name of the participants position
birthdate	Participants date of birth
born_place	Participants place of birth
is_retired	Determines if participant has retired. Possible values: yes no
subtype	Participant subtype name. Possible values: athlete coach referee director
..event	node available only if message type is event
id	Identifier 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
name	The name of the event
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 of the event status
sport_id	Identifier for the sport in which the event is played
round_id	Unique identifier for the round in which event is played. Possible null value
round_name	Name of the round. Possible null value.
day	Day 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_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
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
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
id	Unique identifier for the detail. Possible values are different depending on the sport
value	Value related to the detail
....participants
.....participant
counter	Number of participant in the event. Participant with counter="1" is the home team, "2" is the away team
id	Unique identifier of the participant
name	Participants name
short_name	Participants abbreviated name, max length: 20 characters
acronym	Max 3 characters in length mini name, e.g. BAR, REA
area_id	Unique identifier for the area represented by the participant
area_name	Area name represented by the participant
area_code	Max 3 characters in length for 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
......results
.......result
id	Unique identifier for the result. Possible values are different depending on the sport
value	Value related to the results
......stats
.......stat
id	Unique identifier for the statistic. Possible values are different depending on the sport
value	Value related to the statistic
......subparticipants
.......subparticipant
id	Unique identifier of the participant
counter	Number of subparticipant in the event
name	Participants name
short_name	Participants abbreviated name, max length: 20 characters
acronym	Max 3 characters in length mini name, e.g. BAR, REA
area_id	Unique identifier for the area represented by the participant
area_name	Area name represented by the participant
area_code	Max 3 characters in length for 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
........results
.........result
id	Unique identifier for the result
value	Value related to the result
........stats
.........stat
id	Unique identifier for the statistic
value	Value 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
message	Response info message.
status	Response code.
..incident
id	Unique 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_id	Identifier for the incident
incident_name	Name of the incident. e.g. goal, yellow card, red card etc.
participant_id	Unique identifier of participant (player, team or coach) name related to incident
participant_name	Participants (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 dont use this attribute
important_for_trader	Possible values: yes no
important	Internal attribute, please dont use this attribute
add_data	Internal attribute, please dont use this attribute
show_popup	Internal attribute, please dont use this attribute
show_scores	Internal attribute, please dont use this attribute
show_action	Internal attribute, please dont use this attribute
show_time	Internal attribute, please dont use this attribute
show_on_timeline	Internal attribute, please dont use this attribute
event_time	Information when the incident occurs in format MM:SS
event_status_id	Unique identifier of the event status
event_status_name	Name of the event status
x_pos	Ball position on X axis (percents)
y_pos	Ball position on Y axis (percents)
...participant
id	Unique identifier for the participant
type	Participant type. Possible values: team person
name	Participant name
short_name	Participants abbreviated name, max length: 20 characters
acronym	Max 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_id	Unique identifier for the area represented by the participant
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
sport_id	Unique identifier for the sport in which the participant takes part
sport_name	Name of the sport in which the participant takes part
national	Determines if the participant is national team. Possible values: yes no
website	Participants official website
ut	Information about the date and time of when the record was last updated. Format UNIX_TIMESTAMP
old_participant_id	deprecated. The attribute will be removed in next API version
slug	friendly url for participant
logo	Attribute for internal purposes
founded	Date when the team was founded
phone	Phone number
email	Email address
address	Address where the team is located
venue_id	Unique identifier for the venue in which the team plays home games
venue_name	Name of the venue in which the team plays home games
weight	Participants weight
height	Participants height
nickname	Participants nickname
position_name	Name of the participants position
birthdate	Participants date of birth
born_place	Participants place of birth
is_retired	Determines if participant has retired. Possible values: yes no
subtype	Participant subtype name. Possible values: athlete coach referee director
..event	node available only if message type is event
id	Identifier 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
name	The name of the event
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 of the event status
sport_id	Identifier for the sport in which the event is played
round_id	Unique identifier for the round in which event is played. Possible null value
round_name	Name of the round. Possible null value.
day	Day 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_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
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
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
id	Unique identifier for the detail. Possible values are different depending on the sport
value	Value related to the detail
....participants
.....participant
counter	Number of participant in the event. Participant with counter="1" is the home team, "2" is the away team
id	Unique identifier of the participant
name	Participants name
short_name	Participants abbreviated name, max length: 20 characters
acronym	Max 3 characters in length mini name, e.g. BAR, REA
area_id	Unique identifier for the area represented by the participant
area_name	Area name represented by the participant
area_code	Max 3 characters in length for 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
......results
.......result
id	Unique identifier for the result. Possible values are different depending on the sport
value	Value related to the results
......stats
.......stat
id	Unique identifier for the statistic. Possible values are different depending on the sport
value	Value related to the statistic
......subparticipants
.......subparticipant
id	Unique identifier of the participant
counter	Number of subparticipant in the event
name	Participants name
short_name	Participants abbreviated name, max length: 20 characters
acronym	Max 3 characters in length mini name, e.g. BAR, REA
area_id	Unique identifier for the area represented by the participant
area_name	Area name represented by the participant
area_code	Max 3 characters in length for 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
........results
.........result
id	Unique identifier for the result
value	Value related to the result
........stats
.........stat
id	Unique identifier for the statistic
value	Value related to the statistic