Resource information
| URL | https://api.softnetsport.com/v2/events/{eventId}/incidents |
|---|---|
| XSD | https://api.softnetsport.com/assets/API/docs/xsd/events.incidents.index.xsd |
| Method | GET |
Description | Returns a list of incidents for the selected event. |
| Cache | Not cached |
| Authorization required | Yes |
| Internal method | Yes |
Method parameters
| Name | Type | Description |
|---|---|---|
| There are no method parameters in this resource | ||
Query parameters
| Name | Type | Description |
|---|---|---|
| statuses | xsd:string | Determines incidents status identifiers, separated by a comma (e.g. 123,234,321) |
| incidents | xsd:string | Determines incidents identifiers, separated by a comma (e.g. 123,234,321) |
| important | xsd:string | Determines only important or not important incidents. Possible values: yes, no. |
| updated | xsd:string | Determines only updated or not updated incidents. Possible values: yes, no. |
| deleted | xsd:string | Determines to list only deleted or not deleted incidents. Possible values: yes, no. |
| 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 |
Method calling examples
Link | Description |
|---|---|
| https://api.softnetsport.com/v2/events/1877031/incidents?username=softnetsport&incidents=410,413&limit=5 | Returns a list of event incidents. |
Output elements
.event_incidents | Data type | Description |
|---|---|---|
| ..incident | ||
| id | xsd:array | Incident identifier. Unique for sport. |
| incident_id | xsd:int | Incident id in data.sports.incidents node for event from 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 from resource sports.show |
| 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 |
| add_data | xsd:string | Custom information |
| display_info | xsd:string | Label for incidents |
| old_added_id | xsd:int | DEPRECATED. Old Id |
// TODO : DOKOŃCZYĆ
. . . . . . result . . . . . . stat . . . . . results . . . . . stats
. . . . 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
websiteParticipants official websitewinner_idWho is the winner of the match