Soccer APIs - VAR Decisions

We’ve added the decision data point for VAR review events across Soccer and Soccer Extended API Timeline endpoints. Previously available only in the Soccer Extended Timeline endpoint, decision now appears on video_assistant_referee_over events and indicates the outcome of the VAR review.

Possible values:pending, cancelled, upheld, overturned

⭐ Benefit

The decision data point gives you a complete picture of each VAR review — from the initial review trigger to the final outcome — so you can surface accurate, detailed VAR event data in your platform.

Learn more in our VAR Review Process guide.

☑️ Sample Request:

Sport Event Timeline (Match 70076100)

curl --request GET \
     --url https://api.sportradar.com/soccer-extended/trial/v4/en/sport_events/sr:sport_event:70076100/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 Timeline
Push Events

⚙️ Return Sample

A VAR sequence consists of two events: a video_assistant_referee event when the review is initiated, and a video_assistant_referee_over event when the review concludes. The decision field appears only on the closing video_assistant_referee_over event. Other timeline events may appear between the two VAR events.

<!-- VAR review initiated -->
<event id="3000032774" type="video_assistant_referee" time="2026-04-29T01:07:33+00:00" match_time="50" match_clock="49:14" competitor="away" period="2" period_type="regular_period" description="penalty"/>

<!-- Unrelated timeline event occurring during the review -->
<event id="3000032899" type="dribble" time="2026-04-29T01:10:21+00:00" match_time="52" match_clock="51:17" competitor="away" x="8" y="72" period="2" period_type="regular_period" outcome="successful">
    <players>
        <player id="sr:player:2150446" name="Veliz, Alejo" competitor_id="sr:competitor:3217"/>
    </players>
</event>

<!-- VAR review concluded — decision returned here -->
<event id="3000032882" type="video_assistant_referee_over" time="2026-04-29T01:09:38+00:00" match_time="52" match_clock="51:19" competitor="away" period="2" period_type="regular_period" description="penalty" decision="upheld"/>

// VAR review initiated
{
    "id": 3000032774,
    "type": "video_assistant_referee",
    "time": "2026-04-29T01:07:33+00:00",
    "match_time": 50,
    "match_clock": "49:14",
    "competitor": "away",
    "period": 2,
    "period_type": "regular_period",
    "description": "penalty"
},

// Unrelated timeline event occurring during the review
{
    "id": 3000032899,
    "type": "dribble",
    "time": "2026-04-29T01:10:21+00:00",
    "match_time": 52,
    "match_clock": "51:17",
    "competitor": "away",
    "x": 8,
    "y": 72,
    "period": 2,
    "period_type": "regular_period",
    "players": [
        {
            "id": "sr:player:2150446",
            "name": "Veliz, Alejo",
            "competitor_id": "sr:competitor:3217"
        }
    ],
    "outcome": "successful"
},

// VAR review concluded — decision returned here
{
    "id": 3000032882,
    "type": "video_assistant_referee_over",
    "time": "2026-04-29T01:09:38+00:00",
    "match_time": 52,
    "match_clock": "51:19",
    "competitor": "away",
    "period": 2,
    "period_type": "regular_period",
    "description": "penalty",
    "decision": "upheld"
}