Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Resource information

URLhttps://api.softnetsportstatscore.com/v2/events/{eventId}/incidentsXSDhttps://api.softnetsport.com/assets/API/docs/xsd/events.incidents.index.xsd
MethodGET

Description

Returns a list of incidents for the selected event.

CacheNot cached
Authorization requiredYes
Internal methodYes

Method parameters

There are no method parameters in this resource 
NameTypeData typeDescription
event_idxsd:intREQUIRED. The requested event identifier

Query parameters

NameTypeDescription
statusesxsd:stringDetermines incidents status identifiers, separated by a comma (e.g. 123,234,321) 
incidentsxsd:stringDetermines incidents identifiers, separated by a comma (e.g. 123,234,321)
importantxsd:string

Determines only important or not important incidents.

Possible values: yes, no.

updatedxsd:string

Determines only updated or not updated incidents.

Possible values: yes, no.

deletedxsd:string

Determines to list only deleted or not deleted incidents.

Possible values: yes, no.

pagexsd:intDetermines offset of paginated data. Default value is 1 which means first page
limitxsd: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

sort_order xsd:string

Additional parameter for sort_type which determines the direction of sorting (ascending, descending).

The resource is sorted by sport-specific status then after the time in that status.

By default the value of "desc" is set. Possible values:

  • asc - sort ascending
  • desc - sort descending

Method calling examples

Link
Description
https://api.softnetsportstatscore.com/v2/events/1877031/incidents?username=softnetsport&incidents=410,413&deleted=no&limit=5&token={{YOUR TOKEN}}Returns a list of event incidents.

Output elements

...

...

.event_incidents
Data type
Description
..incident
  


idxsd:arrayIncident identifier. Unique for sport.
action

xsd:string

Describes type of operation. Possible values:

  • insert
  • update
  • delete
old_idxsd:intDEPRECATED. Old Id
event_idxsd:intREQUIRED. The event identifier
incident_idxsd:intIncident id in data.sports.incidents node for event
from resource sports.show
. The complete list of possible incidents can be retrieved using the API resource: sports.show
attribute_idsxsd:arrayAttributes identifiers related to incident, separated by a comma (e.g. [397, 398])
confirmationxsd:string

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_idxsd:intParticipant id
participant_team_idxsd:intParticipant team id
participant_namexsd:stringParticipant name.
status_idxsd:intStatus id in data.sports.statuses node for event
from resource sports.show
. The complete list of possible statuses can be retrieved using the API resource: statuses.index
minutexsd:intIncident time: minute
secondxsd:intIncident time: second
home_scorexsd:intHome Score
away_scorexsd:intAway Score
home_score1xsd:intHome Score 1
away_score1xsd:intAway Score 1
home_score2xsd:intHome Score 2
away_score2xsd:intAway Score 2
x_posxsd:intBall position on X axis (percentage)
y_posxsd:intBall position on Y axis (percentage)
add_dataxsd:stringCustom information
display_infoxsd:stringLabel for incidents
old_added_id
counterxsd:int
DEPRECATED. Old Id

// TODO : DOKOŃCZYĆ

. booked_events
 

. . . . . . result . . . . . . stat . . . . . results . . . . . stats 

. . . . detail

 . . . . participant . . . detailsadditional information related to the event. . . participants . . event acronymMax 3 characters in length mini name, e.g. BAR, REAarea_codeMax 3 characters in length for the abbreviated area name e.g. GER, POL, FRAarea_idUnique identifier for the area represented by the participant.  
area_nameArea name represented by the participantbet_status

Possible value:

  • active
  • suspended

client_event_idUnique event identifier for the client.clock_status

Clock status. Possible value:

  • running
  • stopped

clock_timeHow many seconds have passed in the current event period. Possible empty valuecompetition_idUnique identifier for the competitioncompetition_short_nameAbbreviated name of the competitioncounterNumber of participants in the event. Participant with counter="1" is the home team.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)

dayDay of the seasonft_only

Determines when the result/score of the event is updated. Possible values:

  • yes - result/score is updated only when the event is finished 
  • no - result/score is updated during the event

gender

Participants gender. Possible value:

  • male
  • female
  • mixed (e.g for mixed doubles in tennis )

idUnique identifier for the eventidUnique identifier for the detailsidUnique identifier of the participantidUnique identifier for the resultidUnique identifier for the statisticitem_status

Describes status of the item (record). Possible values:

  • active - the record is active
  • deleted - the record was deleted by the admin. When an event was added by mistake

logoAttribute for internal purposesnameName of the event e.g. Spain - ItalynameName of the details. Possible values are different depending on sport nameParticipants namenameName of the result. Possible values are different depending on sportnameName of the statistic. Possible values are different depending on sportnational

Determines if participant is a national team. Possible values:

  • yes
  • no

neutral_venue

Determines if the event is played at a neutral venue. Possible values:

  • yes
  • no

old_event_iddeprecated. The attribute will be removed in the next API versionold_participant_iddeprecated. The attribute will be removed in the next API versionprogress_idWho advanced to the next roundrelation_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

round_idUnique identifier for the round in which event is played. Possibble null value. round_nameName of the roundscoutsfeed

Information concerning scouts coverage. Possible values:

  • yes - means that play by play incidents will be available for the event
  • no - means that play by play incidents will not be available for the event

short_nameParticipanst abbreviated name, max length: 20 charactersslugfriendly url for eventslugfriendly url for participantsourceIdentificator of scout related to the event. Attribute for internal purposessport_idUnique identifier for the sport in which the participant is involved.
sport_nameName of the sport in which the participant is involved.start_dateDate when the event starts in the format DATE_TIME (2015-03-01 11:02)status_idUnique identifier of the event statusstatus_name

Name of the event status

status_type

Type of status. Possible values:

  • live
  • scheduled
  • finished
  • cancelled
  • interrupted
  • deleted
  • other

type

Participant type. Possible values:

  • team
  • person

utInformation about when the date and time of the event record was last updated. Format UNIX_TIMESTAMPutInformation about when the date and time of the record was last updated. Format UNIX_TIMESTAMPvalueValue related to the detailsvalueValue related to the resultvalueValue related to the statisticverified_result

Possible value:

  • yes - result is verified with official source
  • no - result is not verified with official source
Subsequent number of the incydent type in the event. Example: 5th goal in the match.
ctxsd:intCreated date
utxsd:intLast update date
dtxsd:intDeleted date
additional_infoxsd:arrayContains additional information, e.g. goalkeeper_id, assistant_id (assistant_id = 12345)
old_added_idxsd:intDEPRECATED. Old Id
sort_typexsd:string

Determines sort order of data. Possible values:

  • id - Incidents are sorted by the id of the Incident
forxsd:stringDetermine what the participant includes incident
  • all
  • own
  • rival
  • none