incidents.index [draft]

Resource information

URL	https://api.softnetsport.com/v2/incidents
XSD	https://api.softnetsport.com/assets/API/docs/xsd/incidents.index.xsd
Method	GET
Description	Returns incidents, which may occur during the event
Cache	60 seconds
Authorization required	Yes

Method parameters

Name	Type	Description
There are no method parameters in this resource

Query parameters

Name	Type	Description
token	xsd:string	REQUIRED. More information concerning authorization in API introduction section
lang	xsd:string	Determines language for the output data
page	xsd:int	Determines offset of paginated data. Default value is 1 which means first page.
limit	xsd:int	Determines maximum number of returned records on page. Used in paginated data. Default value is 500. Possible values: 5, 10, 25, 50, 100, 250, 500
sport_id	xsd:int	Identifier for the sport.
multi_ids	xsd:string	Identifiers for the incident.
important	xsd:string	Determines if incidents are important e.g. goals, cards, substitutions. By default all types are included. Allowed values: yes - returns only important incidents no - returns only unimportant incidents
important_for_trader	xsd:string	Determines type of incidents (if it is important for trader). By default all types are included. Allowed values: yes - returns only incidents important for trader no - returns only incidents not important for trader
timestamp	xsd:unix_timestamp	Selection date, format UNIX_TIMESTAMP. Only changes that occurred or were updated after this timestamp will be returned

Method calling examples

Link	Description
https://api.softnetsport.com/v2/incidents.xml?token={{YOUR_TOKEN}}	Returns a list of all incidents in XML format
https://api.softnetsport.com/v2/incidents?token={{YOUR_TOKEN}}	Returns a list of all incidents in JSON format
https://api.softnetsport.com/v2/incidents.xml?token={{YOUR_TOKEN}}&sport_id=1	Returns a list of incidents which are used in basketball

Output elements

incidents

incidents > incident

id	xsd:array	Incident identifier. Unique for sport.
action	xsd:string	Describes type of operation. Possible values: insert update delete
old_id	xsd:int	DEPRECATED. Old Id
event_id	xsd:int	REQUIRED. The event identifier
incident_id	xsd:int	Incident id in data.sports.incidents node for event. The complete list of possible incidents can be retrieved using the API resource: sports.show
participant_id	xsd:int	Participant id
participant_team_id	xsd:int	Participant team id
participant_name	xsd:string	Participant name.
status_id	xsd:int	Status id in data.sports.statuses node for event. The complete list of possible statuses can be retrieved using the API resource: statuses.index
minute	xsd:int	Incident time: minute
second	xsd:int	Incident time: second
home_score	xsd:int	Home Score
away_score	xsd:int	Away Score
home_score1	xsd:int	Home Score 1
away_score1	xsd:int	Away Score 1
home_score2	xsd:int	Home Score 2
away_score2	xsd:int	Away Score 2
x_pos	xsd:int	Ball position on X axis (percentage)
y_pos	xsd:int	Ball position on Y axis (percentage)
add_data	xsd:string	Custom information
display_info	xsd:string	Label for incidents
counter	xsd:int	Subsequent number of the incydent type in the event. Example: 5th goal in the match.
ct	xsd:int	Created date
ut	xsd:int	Last update date
dt	xsd:int	Deleted date
old_added_id	xsd:int	DEPRECATED. Old Id
sort_type	xsd:string	Determines sort order of data. Possible values: id - Incidents are sorted by the id of the Incident
for	xsd:string	Determine what the participant includes incident all own rival none
category	xsd:int	Incident category. Possible values: standard emergency
group	xsd:int	Group of emergency incident. Possible values: prematch live postmatch