Soccer Extended API - Scoring Method
October 30th, 2025
We've added a scoring method to score_change events in our Soccer Extended API.
Use the method value to easily determine the type of score in a match. Valid method values are: penalty, own_goal, header, shot, free_kick, and corner.
This data point was already available in the Soccer v4 API (non-Extended).
☑️ Sample Request:
- Sport Event Timeline -
https://api.sportradar.com/soccer/trial/v4/en/sport_events/ {sport_event_id}/timeline.json
🔢 Versions
🔁 Endpoints Affected
- League Timeline, Live Timelines, Live Timelines Delta, Sport Event Extended Timeline, Sport Event Timelines, Push Events
⚙️ Return Sample
"timeline": [
{
"id": 2180372420,
"type": "match_started",
"time": "2025-10-30T13:00:00+00:00"
},
{
"id": 2180372422,
"type": "period_start",
"time": "2025-10-30T13:00:00+00:00",
"period": 1,
"period_type": "regular_period",
"period_name": "regular_period"
},
{
"id": 2180378700,
"type": "score_change",
"time": "2025-10-30T13:09:41+00:00",
"match_time": 10,
"competitor": "away",
"players": [
{
"id": "sr:player:2296267",
"name": "Toure",
"type": "scorer"
}
],
"x": 11,
"y": 50,
"period": 1,
"period_type": "regular_period",
"home_score": 0,
"away_score": 1,
"method": "penalty"
},
{
"id": 2180401850,
"type": "score_change",
"time": "2025-10-30T13:47:08+00:00",
"match_time": 45,
"match_clock": "45:00",
"competitor": "home",
"players": [
{
"id": "sr:player:2051519",
"name": "Kruspzky, Facundo",
"type": "scorer"
}
],
"x": 92,
"y": 55,
"stoppage_time": 3,
"stoppage_time_clock": "2:08",
"period": 1,
"period_type": "regular_period",
"home_score": 1,
"away_score": 1,
"method": "own_goal"
},
{
"id": 2180404366,
"type": "period_score",
"time": "2025-10-30T13:50:15+00:00",
"period": 1,
"period_type": "regular_period"
},
{
"id": 2180404372,
"type": "break_start",
"time": "2025-10-30T13:50:15+00:00",
"period_type": "pause",
"break_name": "pause"
},
{
"id": 2180416098,
"type": "period_start",
"time": "2025-10-30T14:07:56+00:00",
"period": 2,
"period_type": "regular_period",
"period_name": "regular_period"
}
]
} <timeline>
<event id="2180372420" type="match_started" time="2025-10-30T13:00:00+00:00"/>
<event id="2180372422" type="period_start" time="2025-10-30T13:00:00+00:00" period="1" period_type="regular_period" period_name="regular_period"/>
<event id="2180378700" type="score_change" time="2025-10-30T13:09:41+00:00" match_time="10" competitor="away" x="11" y="50" period="1" period_type="regular_period" home_score="0" away_score="1" method="penalty">
<players>
<player id="sr:player:2296267" name="Toure" type="scorer"/>
</players>
</event>
<event id="2180401850" type="score_change" time="2025-10-30T13:47:08+00:00" match_time="45" match_clock="45:00" competitor="home" x="92" y="55" stoppage_time="3" stoppage_time_clock="2:08" period="1" period_type="regular_period" home_score="1" away_score="1" method="own_goal"/>
<event id="2180404366" type="period_score" time="2025-10-30T13:50:15+00:00" period="1" period_type="regular_period"/>
<event id="2180404372" type="break_start" time="2025-10-30T13:50:15+00:00" period_type="pause" break_name="pause"/>
</timeline>