GuidesRelease Log
Coverage MatrixDocumentationChange LogLog InContact Us
Release Log

Soccer Extended API - Scoring Method

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>