booked-events.index

Resource information

URL	https://api.softnetsport.com/v2/booked-events
XSD	https://api.softnetsport.com/assets/API/docs/xsd/booked-events.index.xsd
Method	GET
Description	Returns a list of events booked by the client for the selected product. Please note: the list will only contain events with the status: "finished", "live" and "scheduled" including events for the next 14 days. Default order for returned data is: start date - ascending.
Cache	900 seconds (15 min.)
Authorization required	No

Method parameters

Name	Type	Description
There are no method parameters in this resource

Query parameters

Name	Type	Description
client_id	xsd:int	REQUIRED. Assigned to you by the API administrator
product	xsd:string	REQUIRED. Determines product in which given events were booked. Possible values: livescorepro scoutsfeed scoreframe
events_details	xsd:string	Determines if subnodes of events (details, participants, results, stats) will be visible. Possible values: yes - event subnodes will be shown no - event subnodes will be hidden
mapped_status	xsd:string	Determines if events are mapped with client_event_id. Possible values: mapped - display events mapped with customer unmapped - display events unmapped with customer all - display all events (mapped and unmapped)
multi_ids	xsd:string	List of events identifiers separated by a comma (e.g. 123,234,321) for which you want to get the events details
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

Method calling examples

Link	Description
https://api.softnetsport.com/v2/booked-events.xml?client_id=1&product=livescorepro&events_details=no	Returns a list of booked events without detailed node about events.

Output elements

. booked_events
. . event
id	Unique identifier for the event
client_event_id	Unique event identifier for the client.
name	Name of the event e.g. Spain - Italy
start_date	Date when the event starts in the format DATE_TIME (2015-03-01 11:02)
ft_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
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)
scoutsfeed	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
status_id	Unique identifier of the event status
status_name	Name of the event status
status_type	Type of status. Possible values: live scheduled finished cancelled interrupted deleted other
clock_time	How many seconds have passed in the current event period. Possible empty value
clock_status	Clock status. Possible value: running stopped
bet_status	Possible value: 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
source	Identificator of scout related to the event. Attribute for internal purposes
winner_id	Who is the winner of the match
progress_id	Who advanced to the next round
day	Day of the season
round_id	Unique identifier for the round in which event is played. Possibble null value.
round_name	Name of the round
neutral_venue	Determines if the event is played at a neutral venue. Possible values: yes no
item_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
verified_result	Possible value: yes - result is verified with official source no - result is not verified with official source
ut	Information about when the date and time of the event record was last updated. Format UNIX_TIMESTAMP
old_event_id	deprecated. The attribute will be removed in the next API version
slug	friendly url for event
competition_id	Unique identifier for the competition
competition_short_name	Abbreviated name of the competition
. . . details	additional information related to the event
. . . . detail
id	Unique identifier for the details
name	Name of the details. Possible values are different depending on sport
value	Value related to the details
. . . participants
. . . . participant
counter	Number of participants in the event. Participant with counter="1" is the home team.
id	Unique identifier of the participant
type	Participant type. Possible values: team person
name	Participants name
short_name	Participanst abbreviated name, max length: 20 characters
acronym	Max 3 characters in length mini name, e.g. BAR, REA
gender	Participants gender. Possible value: male female mixed (e.g for mixed 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 for the abbreviated area name e.g. GER, POL, FRA
sport_id	Unique identifier for the sport in which the participant is involved.
sport_name	Name of the sport in which the participant is involved.
national	Determines if participant is a national team. Possible values: yes no
website	Participants official website
ut	Information about when the date and time of the record was last updated. Format UNIX_TIMESTAMP
old_participant_id	deprecated. The attribute will be removed in the next API version
slug	friendly url for participant
logo	Attribute for internal purposes
. . . . . results
. . . . . . result
id	Unique identifier for the result
name	Name of the result. Possible values are different depending on sport
value	Value related to the result
. . . . . stats
. . . . . . stat
id	Unique identifier for the statistic
name	Name of the statistic. Possible values are different depending on sport
value	Value related to the statistic