Soccer APIs - New VAR Event Descriptions and Player Node

Four new description values have been added to the Soccer Timeline endpoints for Video Assistant Referee events.

Additionally, VAR timeline events will now have the ability to include an associated player name and Id.

Added description values:

corner
no_corner
mistaken_identity
no_mistaken_identity

⭐ Benefit

The new corner and mistaken_identity description values provide greater context into the outcome of a VAR review, enabling developers to surface more detailed decision data in their applications. The addition of the player node further enriches timeline events by associating specific players with VAR incidents.

Learn more in our VAR Review Process guide, or locate valid enums in our Soccer FAQ.

☑️ Sample Request:

Sport Event Timeline

curl --request GET \
     --url https://api.sportradar.com/soccer-extended/trial/v4/en/sport_events/{sport_event_id}/timeline.json \
     --header 'accept: application/json' \
     --header 'x-api-key: YOUR_API_KEY'

🔢 Versions

🔁 Endpoints Affected

Soccer

Live Timelines
Live Timelines Delta
Sport Event Timeline
Push Events

Soccer Extended

Live Timelines
Live Timelines Delta
Sport Event Extended Timeline
Sport Event Timeline
Push Events

⚙️ Return Sample

<event id="4587691" type="video_assistant_referee" time="2025-08-25T20:21:57+00:00" match_time="61" match_clock="60:40" competitor="away" period="2" period_type="regular_period" description="red_card">
  <players>
    <player id="sr:player:560128" name="Joelinton" competitor_id="sr:competitor:39"/>
  </players>
</event>
<event id="4587738" type="video_assistant_referee_over" time="2025-08-25T20:22:39+00:00" match_time="62" match_clock="61:22" competitor="away" period="2" period_type="regular_period" description="no_red_card" decision="cancelled">
  <players>
    <player id="sr:player:560128" name="Joelinton" competitor_id="sr:competitor:39"/>
  </players>
</event>

<event id="4587691" type="video_assistant_referee" time="2025-08-25T20:21:57+00:00" match_time="61" match_clock="60:40" competitor="away" period="2" period_type="regular_period" description="corner"/>
<event id="4587738" type="video_assistant_referee_over" time="2025-08-25T20:22:39+00:00" match_time="62" match_clock="61:22" competitor="away" period="2" period_type="regular_period" description="no_corner" decision="cancelled"/>

<event id="4587691" type="video_assistant_referee" time="2025-08-25T20:21:57+00:00" match_time="61" match_clock="60:40" competitor="away" period="2" period_type="regular_period" description="mistaken_identity"/>
<event id="4587738" type="video_assistant_referee_over" time="2025-08-25T20:22:39+00:00" match_time="62" match_clock="61:22" competitor="away" period="2" period_type="regular_period" description="no_mistaken_identity" decision="cancelled"/>