Timeline end point

This end point provides information related to the match while the match is ongoing. Apart from the general information related to the match it provides info related for example to score changes, yellow cards, corner kicks etc.

In order to call the end point for a specific match, the id of the match must be inserted in the call as per following example:

/v1/sports/{language}/sport_events/sr:match:14704749/timeline.xml

Main elements and sub elements provided by the Timeline end points are the ones shown in list below:

  • match_summary

  • sport_event

    • tournament_round

    • season

    • tournament

      • competitor

        • reference_ids

          • reference_id

      • venue

      • sport_event_conditions

        • referee

        • venue

        • weather_info

      • sport_event_status

        • period_scores

          • period_score competitors

          • coverage_info

          • timeline

            • event

Tournament_round element (tournament_round)

Information related to the tournament round element is available here: Tournament_round

Tournament element

Information related to the tournament element is available here: Tournament

Season Element (season)

Information related to the Season element is available here: Season

Competitors element

Information related to the competitors element is available here: Competitor

Venue element

Information related to the competitors element is available here: Venue

Sport event status

Information related to the competitors element is available here: Sport event status

Sport event conditions

For more detailed info related to the Venue element, please, check the following page: Sport_event_condition

For more detailed info related to the Venue element, please, check the following page: Venue

For more detailed info related to the Pitcher and Pitcher history, please, check the following page: Pitcher and Pitcher history

Sport event status

For detailed information about the sport event status element please check: Sport event status

Period Scores

For detailed information about the sport event status element please check: Period scores

Coverage info

For more detailed info related to Coverage info please, refer to page: Coverage_info

Timeline

The main difference between the summary end point and the timeline end point is the list of event elements in the timeline which provides info related to the ongoing match.

Here below follows the list of the possible types of events reported in the timeline end point.

  • match_started

  • period_start

  • yellow_card

  • red_card

  • red_yellow_card

  • period_score

  • break_start

  • score_change

  • corner_kick

  • match_ended

match_started

Each event has an id to be identified.

This event type provides info about the timing match start as shown in example below.

yellow_and red card

This event type provides info about a yellow card given to a player.

Information provided is:

  • id of the event

  • time of the event

  • time in the match

  • the team the player belongs in

  • if the player is on the bench

The sub element <player> is added with id and name of the player as shown in the 2 examples below

red_yellow_card

This event type provides info about a player who got first the yellow card given to a player and the player is sent off.

Info about the player is provided as well.

period_score

This event type provides info about a period score with time, period number, home_score, away_score and match_status_code.

break_start

This event type provides info about a break during the match with time, period name and match_status_code.

score_change

This event type provides info about a break during the match with time, period name and match_status_code.

Apart from that also information related to the

corner_kick

This event type provides info about a corner kick during the match with time, match_time period name and match_status_code.

match_ended

This event type provides info about the end of the match.

period_start

This event type provides info about the start of the period and the period itself.

Was this helpful?