Coverage

What leagues or tournaments do you cover for soccer?

You can find all the leagues we cover, as well as a breakdown of data offered, via our Coverage Matrix.

When is coverage information added to the endpoints?

On the first day of the season.

How do I find out the coverage for a particular match?

Find the node for coverage within the Summaries, Lineups, and Timeline endpoints.

Coverage nodes have three types: competition level, group level, and sport_event level.

The competition level describes data coverage you can expect for matches involved in that given competition.
The group level is similar because there exists competitions where coverage levels differ at different stages or in different groups - mostly cup competitions.
The sport_event level describes the data depth of a specific match within the group and season.

Note: There are occasions when the sport_event coverage can vary from the anticipated season coverage. This node exists to highlight that instance and assist in handling any discrepancies.

<coverage type="sport_event">
    <sport_event_properties lineups="true" venue="true" extended_player_stats="true" extended_team_stats="true" basic_play_by_play="true" basic_player_stats="true" basic_team_stats="true"/>
</coverage>

<coverage type="competition">
  <competition_properties brackets="false" missing_players="false" player_transfer_history="false" 
      schedules="true" season_player_statistics="false" season_stats_leaders="false" 
      season_team_statistics="false" standings="false" team_squads="false"/>
  <sport_event_properties basic_play_by_play="false" basic_player_stats="false" basic_team_stats="false" 
      extended_player_stats="false" extended_team_stats="false" deeper_play_by_play="false" 
      deeper_team_stats="false" deeper_player_stats="false" lineups="false" goal_scorers="true" 
      scores="live" assists="false"/>
</coverage>

How is coverage for a particular match defined?

The coverage nodes contain classifications of data types which are expressed as Boolean values or denoted as live or post.

<coverage type="sport_event">
    <sport_event_properties lineups="false" venue="false" extended_player_stats="false" extended_team_stats="false" 
      ballspotting="false" commentary="false" fun_facts="false" goal_scorers="false" scores="post" game_clock="false" 
      deeper_play_by_play="false" deeper_player_stats="false" deeper_team_stats="false" basic_play_by_play="false" 
      basic_player_stats="false" basic_team_stats="false"/>
</coverage>

How do you define basic and deeper play-by-play in terms of coverage?

basic_play_by_play includes score_change, cards, and substitutions.
deeper_play_by_play includes all other event types.

How will a sport event behave when it is not covered with live scores?

When a sport_event is not covered live, the status and match_status will remain as not_started until results are entered post-match.

<sport_event_status status="not_started" match_status="not_started"/>

How are “Live” endpoints handled in the API?

Sport Events appear in the feed 10 minutes before the scheduled start time and are removed 10 minutes after the Sport Event is ended. Live endpoints include: Live Summaries, Live Timelines, and Live Timelines Delta.

How are friendlies handled in the Summary endpoints?

The Summary endpoints return all Friendlies played in the last 2 weeks and scheduled for the next 4 weeks.

What level of coverage is offered for friendly competitions?

Friendly competitions are handled uniquely, with coverage being set on a case-by-case basis. Selected matches will be scouted and will therefore have live coverage. We would suggest checking sport_event_properties within each sport_event to understand the coverage set for a particular match.

Will qualification rounds match the coverage of group stage/knockout rounds?

No, in some instances qualification matches will be covered at a lower tier than subsequent rounds.

We suggest to use the Season Info endpoint, which has a coverage property for each individual stage within a season. See below for sample data.

<?xml version="1.0" encoding="UTF-8"?>
<season_info xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" generated_at="2024-08-01T15:06:45+00:00" xmlns="http://schemas.sportradar.com/sportsapi/soccer/v4" xsi:schemaLocation="http://schemas.sportradar.com/sportsapi/soccer/v4 https://schemas.sportradar.com/sportsapi/soccer/v4/schemas/season_info.xsd">
    <coverage type="competition">
        <competition_properties missing_players="false" player_transfer_history="false" schedules="false" season_player_statistics="true" season_stats_leaders="true" season_team_statistics="true" standings="false" team_squads="true"/>
        <sport_event_properties basic_play_by_play="true" basic_player_stats="true" basic_team_stats="true" extended_player_stats="false" extended_team_stats="false" deeper_play_by_play="true" deeper_team_stats="true" deeper_player_stats="true" lineups="true" goal_scorers="true" scores="live" assists="false"/>
    </coverage>
    <season id="sr:season:119783" name="UEFA Conference League 24/25" start_date="2024-07-10" end_date="2025-05-28" year="24/25" competition_id="sr:competition:34480">
        <sport id="sr:sport:1" name="Soccer"/>
        <category id="sr:category:393" name="International Clubs"/>
        <competition id="sr:competition:34480" name="UEFA Conference League" gender="men"/>
    </season>
    <stages>
        <stage order="1" type="cup" phase="qualification" start_date="2024-07-10" end_date="2024-08-15" year="24/25">
            <groups>
                <group id="sr:cup:166633" name="Qualification">
                    <competitors>
                        <competitor id="sr:competitor:660" name="Tromsoe IL" country="Norway" country_code="NOR" abbreviation="TIL" gender="male"/>
                        <competitor id="sr:competitor:1159" name="SK Brann" country="Norway" country_code="NOR" abbreviation="BRA" gender="male"/>
                        <competitor id="sr:competitor:1281" name="Broendby IF" country="Denmark" country_code="DNK" abbreviation="BRO" gender="male"/>
                        <competitor id="sr:competitor:1284" name="FC Copenhagen" country="Denmark" country_code="DNK" abbreviation="FCC" gender="male"/>
                        <competitor id="sr:competitor:1759" name="Djurgardens IF" country="Sweden" country_code="SWE" abbreviation="DJU" gender="male"/>
                        <competitor id="sr:competitor:1760" name="Hacken Gothenburg" country="Sweden" country_code="SWE" abbreviation="HAC" gender="male"/>
                        <competitor id="sr:competitor:1899" name="Valur Reykjavik" country="Iceland" country_code="ISL" abbreviation="VAL" gender="male"/>
                        <competitor id="sr:competitor:1901" name="Breidablik Kopavogur" country="Iceland" country_code="ISL" abbreviation="KOP" gender="male"/>
                        <competitor id="sr:competitor:1908" name="Vikingur Reykjavik" country="Iceland" country_code="ISL" abbreviation="VIK" gender="male"/>
                        <competitor id="sr:competitor:1912" name="Stjarnan Gardabae" country="Iceland" country_code="ISL" abbreviation="STJ" gender="male"/>
                        <competitor id="sr:competitor:1926" name="Fehervar FC Szekesfehervar" country="Hungary" country_code="HUN" abbreviation="FEH" gender="male"/>
                        <competitor id="sr:competitor:2036" name="HNK Hajduk Split" country="Croatia" country_code="HRV" abbreviation="HAJ" gender="male"/>
                        <competitor id="sr:competitor:2040" name="NK Osijek" country="Croatia" country_code="HRV" abbreviation="OSI" gender="male"/>
                        <competitor id="sr:competitor:2203" name="FK Austria Wien" country="Austria" country_code="AUT" abbreviation="FAK" gender="male"/>
                        <competitor id="sr:competitor:2204" name="FC Banik Ostrava" country="Czechia" country_code="CZE" abbreviation="BAN" gender="male"/>
                        <competitor id="sr:competitor:2224" name="FK Mlada Boleslav" country="Czechia" country_code="CZE" abbreviation="MLA" gender="male"/>
                        <competitor id="sr:competitor:2244" name="Kuopion Palloseura" country="Finland" country_code="FIN" abbreviation="KUPS" gender="male"/>
                        <competitor id="sr:competitor:2246" name="Vaasan Palloseura" country="Finland" country_code="FIN" abbreviation="VPS" gender="male"/>
                        <competitor id="sr:competitor:2359" name="St Mirren FC" country="Scotland" country_code="SCO" abbreviation="MIR" gender="male"/>
                        <competitor id="sr:competitor:2406" name="FC Spartak Trnava" country="Slovakia" country_code="SVK" abbreviation="TRN" gender="male"/>
                        <competitor id="sr:competitor:2416" name="Olimpija Ljubljana" country="Slovenia" country_code="SVN" abbreviation="OLI" gender="male"/>
                        <competitor id="sr:competitor:2420" name="NK Maribor" country="Slovenia" country_code="SVN" abbreviation="MAR" gender="male"/>
                        <competitor id="sr:competitor:2442" name="FC St. Gallen 1879" country="Switzerland" country_code="CHE" abbreviation="STG" gender="male"/>
                        <competitor id="sr:competitor:2450" name="FC Zurich" country="Switzerland" country_code="CHE" abbreviation="FCZ" gender="male"/>
                        <competitor id="sr:competitor:2463" name="FC Vaduz" country="Switzerland" country_code="CHE" abbreviation="VAD" gender="male"/>
                        <competitor id="sr:competitor:2903" name="KAA Gent" country="Belgium" country_code="BEL" abbreviation="KAA" gender="male"/>
                        <competitor id="sr:competitor:2979" name="Go Ahead Eagles" country="Netherlands" country_code="NLD" abbreviation="GAE" gender="male"/>
                        <competitor id="sr:competitor:3009" name="Vitoria SC Guimaraes" country="Portugal" country_code="PRT" abbreviation="VIT" gender="male"/>
                        <competitor id="sr:competitor:3086" name="Istanbul Basaksehir" country="Turkiye" country_code="TUR" abbreviation="BAS" gender="male"/>
                        <competitor id="sr:competitor:3106" name="Legia Warszawa" country="Poland" country_code="POL" abbreviation="LEG" gender="male"/>
                        <competitor id="sr:competitor:3108" name="WKS Slask Wroclaw" country="Poland" country_code="POL" abbreviation="SLA" gender="male"/>
                        <competitor id="sr:competitor:3169" name="Saint Patrick´s Athletic FC" country="Ireland" country_code="IRL" abbreviation="STP" gender="male"/>
                        <competitor id="sr:competitor:3170" name="Derry City FC" country="Ireland" country_code="IRL" abbreviation="DER" gender="male"/>
                        <competitor id="sr:competitor:3174" name="Shelbourne FC" country="Ireland" country_code="IRL" abbreviation="SHE" gender="male"/>
                        <competitor id="sr:competitor:3250" name="AEK Athens" country="Greece" country_code="GRC" abbreviation="AEK" gender="male"/>
                        <competitor id="sr:competitor:3280" name="PFC Cherno More Varna" country="Bulgaria" country_code="BGR" abbreviation="CMV" gender="male"/>
                        <competitor id="sr:competitor:3342" name="FCI Levadia Tallinn" country="Estonia" country_code="EST" abbreviation="LEV" gender="male"/>
                        <competitor id="sr:competitor:3346" name="Flora Tallinn" country="Estonia" country_code="EST" abbreviation="FLO" gender="male"/>
                        <competitor id="sr:competitor:3356" name="FC Neman Grodno" country="Belarus" country_code="BLR" abbreviation="NEM" gender="male"/>
                        <competitor id="sr:competitor:3359" name="FC Torpedo Belaz Zhodino" country="Belarus" country_code="BLR" abbreviation="TOR" gender="male"/>
                        <competitor id="sr:competitor:3395" name="AC Omonia Nicosia" country="Cyprus" country_code="CYP" abbreviation="OMO" gender="male"/>
                        <competitor id="sr:competitor:3404" name="AEK Larnaca" country="Cyprus" country_code="CYP" abbreviation="AEK" gender="male"/>
                        <competitor id="sr:competitor:4909" name="Caernarfon Town FC" country="Wales" country_code="WAL" abbreviation="CAT" gender="male"/>
                        <competitor id="sr:competitor:4912" name="Connah's Quay Nomads FC" country="Wales" country_code="WAL" abbreviation="CQN" gender="male"/>
                        <competitor id="sr:competitor:5143" name="FK Buducnost" country="Montenegro" country_code="MNE" abbreviation="BUD" gender="male"/>
                        <competitor id="sr:competitor:5171" name="FC Dinamo Tbilisi" country="Georgia" country_code="GEO" abbreviation="TBI" gender="male"/>
                        <competitor id="sr:competitor:5178" name="HSK Zrinjski Mostar" country="Bosnia &amp; Herzegovina" country_code="BIH" abbreviation="ZRI" gender="male"/>
                        <competitor id="sr:competitor:5180" name="Crusaders FC" country="Northern Ireland" country_code="NIR" abbreviation="CRU" gender="male"/>
                        <competitor id="sr:competitor:5181" name="Cliftonville FC" country="Northern Ireland" country_code="NIR" abbreviation="CLI" gender="male"/>
                        <competitor id="sr:competitor:5185" name="B36 Torshavn" country="Faroe Islands" country_code="FRO" abbreviation="B36" gender="male"/>
                        <competitor id="sr:competitor:5187" name="HB Torshavn" country="Faroe Islands" country_code="FRO" abbreviation="HB" gender="male"/>
                        <competitor id="sr:competitor:5193" name="Vikingur Gota" country="Faroe Islands" country_code="FRO" abbreviation="VIK" gender="male"/>
                        <competitor id="sr:competitor:5195" name="KF Tirana" country="Albania" country_code="ALB" abbreviation="KFT" gender="male"/>
                        <competitor id="sr:competitor:5197" name="Maccabi Haifa FC" country="Israel" country_code="ISR" abbreviation="MAH" gender="male"/>
                        <competitor id="sr:competitor:5202" name="Hapoel Be`er Sheva FC" country="Israel" country_code="ISR" abbreviation="HBS" gender="male"/>
                        <competitor id="sr:competitor:5206" name="Sliema Wanderers" country="Malta" country_code="MLT" abbreviation="SLI" gender="male"/>
                        <competitor id="sr:competitor:5207" name="F91 Dudelange" country="Luxembourg" country_code="LUX" abbreviation="F91" gender="male"/>
                        <competitor id="sr:competitor:5214" name="FC Pyunik Yerevan" country="Armenia" country_code="ARM" abbreviation="PYU" gender="male"/>
                        <competitor id="sr:competitor:5222" name="Partizani Tirana" country="Albania" country_code="ALB" abbreviation="PTI" gender="male"/>
                        <competitor id="sr:competitor:5225" name="FC Urartu Yerevan" country="Armenia" country_code="ARM" abbreviation="URA" gender="male"/>
                        <competitor id="sr:competitor:5237" name="FK Sarajevo" country="Bosnia &amp; Herzegovina" country_code="BIH" abbreviation="FKS" gender="male"/>
                        <competitor id="sr:competitor:5265" name="FC Zimbru Chisinau" country="Moldova" country_code="MDA" abbreviation="ZIM" gender="male"/>
                        <competitor id="sr:competitor:5272" name="Linfield FC" country="Northern Ireland" country_code="NIR" abbreviation="LIN" gender="male"/>
                        <competitor id="sr:competitor:5287" name="FC CFR 1907 Cluj" country="Romania" country_code="ROU" abbreviation="CFR" gender="male"/>
                        <competitor id="sr:competitor:5345" name="Vilnius FK Zalgiris" country="Lithuania" country_code="LTU" abbreviation="ZAL" gender="male"/>
                        <competitor id="sr:competitor:5346" name="FK Auda Riga" country="Latvia" country_code="LVA" abbreviation="AUD" gender="male"/>
                        <competitor id="sr:competitor:5355" name="FC Aktobe" country="Kazakhstan" country_code="KAZ" abbreviation="AKT" gender="male"/>
                        <competitor id="sr:competitor:5362" name="Tobol Kostanay" country="Kazakhstan" country_code="KAZ" abbreviation="TOB" gender="male"/>
                        <competitor id="sr:competitor:5366" name="FC Ordabasy" country="Kazakhstan" country_code="KAZ" abbreviation="ORD" gender="male"/>
                        <competitor id="sr:competitor:5413" name="Shkendija Tetovo" country="North Macedonia" country_code="MKD" abbreviation="SHK" gender="male"/>
                        <competitor id="sr:competitor:5418" name="Vllaznia Shkoder" country="Albania" country_code="ALB" abbreviation="KFV" gender="male"/>
                        <competitor id="sr:competitor:5419" name="FC Torpedo Kutaisi" country="Georgia" country_code="GEO" abbreviation="TKU" gender="male"/>
                        <competitor id="sr:competitor:6059" name="Paksi FC" country="Hungary" country_code="HUN" abbreviation="PAK" gender="male"/>
                        <competitor id="sr:competitor:6151" name="FK Velez Mostar" country="Bosnia &amp; Herzegovina" country_code="BIH" abbreviation="VEL" gender="male"/>
                        <competitor id="sr:competitor:6226" name="FK Decic Tuzi" country="Montenegro" country_code="MNE" abbreviation="TUZ" gender="male"/>
                        <competitor id="sr:competitor:7105" name="JK Tallinna Kalev" country="Estonia" country_code="EST" abbreviation="KAL" gender="male"/>
                        <competitor id="sr:competitor:7605" name="FC Differdange 03" country="Luxembourg" country_code="LUX" abbreviation="DIF" gender="male"/>
                        <competitor id="sr:competitor:7704" name="Marsaxlokk FC" country="Malta" country_code="MLT" abbreviation="MAR" gender="male"/>
                        <competitor id="sr:competitor:22386" name="Tampereen Ilves" country="Finland" country_code="FIN" abbreviation="ILV" gender="male"/>
                        <competitor id="sr:competitor:23833" name="DAC 1904 Dunajska Streda" country="Slovakia" country_code="SVK" abbreviation="DDS" gender="male"/>
                        <competitor id="sr:competitor:32476" name="Paide Linnameeskond" country="Estonia" country_code="EST" abbreviation="PAI" gender="male"/>
                        <competitor id="sr:competitor:33583" name="Hamrun Spartans FC" country="Malta" country_code="MLT" abbreviation="HAM" gender="male"/>
                        <competitor id="sr:competitor:33584" name="Floriana FC" country="Malta" country_code="MLT" abbreviation="FLO" gender="male"/>
                        <competitor id="sr:competitor:36019" name="FK Mornar Bar" country="Montenegro" country_code="MNE" abbreviation="MBA" gender="male"/>
                        <competitor id="sr:competitor:36155" name="FC Astana" country="Kazakhstan" country_code="KAZ" abbreviation="FCA" gender="male"/>
                        <competitor id="sr:competitor:36201" name="FC Progres Niederkorn" country="Luxembourg" country_code="LUX" abbreviation="NIE" gender="male"/>
                        <competitor id="sr:competitor:36255" name="Bala Town FC" country="Wales" country_code="WAL" abbreviation="BAT" gender="male"/>
                        <competitor id="sr:competitor:36261" name="AC Virtus" country="San Marino" country_code="SMR" abbreviation="VIR" gender="male"/>
                        <competitor id="sr:competitor:37297" name="FC Dinamo Batumi" country="Georgia" country_code="GEO" abbreviation="BAT" gender="male"/>
                        <competitor id="sr:competitor:37860" name="SP La Fiorita" country="San Marino" country_code="SMR" abbreviation="LAF" gender="male"/>
                        <competitor id="sr:competitor:37862" name="SP Tre Penne" country="San Marino" country_code="SMR" abbreviation="TRP" gender="male"/>
                        <competitor id="sr:competitor:37946" name="Inter Club de Escaldes" country="Andorra" country_code="AND" abbreviation="ESC" gender="male"/>
                        <competitor id="sr:competitor:37962" name="Atletic Club d'Escaldes" country="Andorra" country_code="AND" abbreviation="ATL" gender="male"/>
                        <competitor id="sr:competitor:42965" name="FC Isloch" country="Belarus" country_code="BLR" abbreviation="ISL" gender="male"/>
                        <competitor id="sr:competitor:43576" name="GFK Tikvesh 1930" country="North Macedonia" country_code="MKD" abbreviation="GFK" gender="male"/>
                        <competitor id="sr:competitor:43981" name="FK Radnicki 1923 Kragujevac" country="Serbia" country_code="SRB" abbreviation="RAD" gender="male"/>
                        <competitor id="sr:competitor:44497" name="Sumgayit FK" country="Azerbaijan" country_code="AZE" abbreviation="SUM" gender="male"/>
                        <competitor id="sr:competitor:46353" name="FC Una Strassen" country="Luxembourg" country_code="LUX" abbreviation="UNA" gender="male"/>
                        <competitor id="sr:competitor:53475" name="FC Milsami" country="Moldova" country_code="MDA" abbreviation="MIL" gender="male"/>
                        <competitor id="sr:competitor:116223" name="CS Universitatea Craiova" country="Romania" country_code="ROU" abbreviation="CSU" gender="male"/>
                        <competitor id="sr:competitor:116312" name="FC Iberia 1999" country="Georgia" country_code="GEO" abbreviation="IBE" gender="male"/>
                        <competitor id="sr:competitor:126312" name="St Joseph`s FC" country="Gibraltar" country_code="GIB" abbreviation="STJ" gender="male"/>
                        <competitor id="sr:competitor:146336" name="FK Liepaja" country="Latvia" country_code="LVA" abbreviation="LIE" gender="male"/>
                        <competitor id="sr:competitor:162368" name="Riga FC" country="Latvia" country_code="LVA" abbreviation="RFC" gender="male"/>
                        <competitor id="sr:competitor:171626" name="Pafos FC" country="Cyprus" country_code="CYP" abbreviation="PAF" gender="male"/>
                        <competitor id="sr:competitor:173406" name="Zira FK" country="Azerbaijan" country_code="AZE" abbreviation="ZIR" gender="male"/>
                        <competitor id="sr:competitor:277835" name="KF Drita" country="Kosovo" country_code="KOS" abbreviation="DRI" gender="male"/>
                        <competitor id="sr:competitor:277847" name="KF Llapi" country="Kosovo" country_code="KOS" abbreviation="LAP" gender="male"/>
                        <competitor id="sr:competitor:280003" name="FC Ballkani" country="Kosovo" country_code="KOS" abbreviation="BAL" gender="male"/>
                        <competitor id="sr:competitor:288687" name="FC CSKA 1948" country="Bulgaria" country_code="BGR" abbreviation="CSK" gender="male"/>
                        <competitor id="sr:competitor:299146" name="FC Struga Trim Lum" country="North Macedonia" country_code="MKD" abbreviation="STL" gender="male"/>
                        <competitor id="sr:competitor:340394" name="FCB Magpies" country="Gibraltar" country_code="GIB" abbreviation="FCB" gender="male"/>
                        <competitor id="sr:competitor:350828" name="FC Polissya Zhytomyr" country="Ukraine" country_code="UKR" abbreviation="POL" gender="male"/>
                        <competitor id="sr:competitor:362744" name="Bravo Ljubljana" country="Slovenia" country_code="SVN" abbreviation="BRA" gender="male"/>
                        <competitor id="sr:competitor:364472" name="FC Ararat-Armenia" country="Armenia" country_code="ARM" abbreviation="ARA" gender="male"/>
                        <competitor id="sr:competitor:364474" name="FC Noah Yerevan" country="Armenia" country_code="ARM" abbreviation="FCN" gender="male"/>
                        <competitor id="sr:competitor:372056" name="KF Egnatia Rrogozhine" country="Albania" country_code="ALB" abbreviation="EGR" gender="male"/>
                        <competitor id="sr:competitor:382568" name="Sabah Masazir" country="Azerbaijan" country_code="AZE" abbreviation="SBH" gender="male"/>
                        <competitor id="sr:competitor:557322" name="FA Siauliai" country="Lithuania" country_code="LTU" abbreviation="SIA" gender="male"/>
                        <competitor id="sr:competitor:617264" name="KF Malisheva" country="Kosovo" country_code="KOS" abbreviation="MAL" gender="male"/>
                        <competitor id="sr:competitor:885005" name="FK Transinvest" country="Lithuania" country_code="LTU" abbreviation="TRA" gender="male"/>
                    </competitors>
                    <coverage type="group">
                        <group_properties brackets="true" cup="true" league="false" missing_players="false" qualification="true" schedules="true" results="true" standings="false" group_stage="false"/>
                        <sport_event_properties basic_play_by_play="false" basic_player_stats="false" basic_team_stats="false" lineups="false" extended_player_stats="false" extended_team_stats="false" deeper_team_stats="false" deeper_player_stats="false" deeper_play_by_play="false" goal_scorers="true" scores="live"/>
                    </coverage>
                </group>
            </groups>
        </stage>
    </stages>
</season_info>

{
    "generated_at": "2024-08-01T15:21:48+00:00",
    "coverage": {
        "type": "competition",
        "competition_properties": {
            "missing_players": false,
            "player_transfer_history": false,
            "schedules": false,
            "season_player_statistics": true,
            "season_stats_leaders": true,
            "season_team_statistics": true,
            "standings": "false",
            "team_squads": true
        },
        "sport_event_properties": {
            "basic_play_by_play": true,
            "basic_player_stats": true,
            "basic_team_stats": true,
            "extended_player_stats": false,
            "extended_team_stats": false,
            "deeper_play_by_play": true,
            "deeper_team_stats": true,
            "deeper_player_stats": true,
            "lineups": true,
            "goal_scorers": true,
            "scores": "live",
            "assists": false
        }
    },
    "season": {
        "id": "sr:season:119783",
        "name": "UEFA Conference League 24/25",
        "start_date": "2024-07-10",
        "end_date": "2025-05-28",
        "year": "24/25",
        "competition_id": "sr:competition:34480",
        "sport": {
            "id": "sr:sport:1",
            "name": "Soccer"
        },
        "category": {
            "id": "sr:category:393",
            "name": "International Clubs"
        },
        "competition": {
            "id": "sr:competition:34480",
            "name": "UEFA Conference League",
            "gender": "men"
        }
    },
    "stages": [
        {
            "order": 1,
            "type": "cup",
            "phase": "qualification",
            "start_date": "2024-07-10",
            "end_date": "2024-08-15",
            "year": "24/25",
            "groups": [
                {
                    "id": "sr:cup:166633",
                    "name": "Qualification",
                    "competitors": [
                        {
                            "id": "sr:competitor:660",
                            "name": "Tromsoe IL",
                            "country": "Norway",
                            "country_code": "NOR",
                            "abbreviation": "TIL",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:1159",
                            "name": "SK Brann",
                            "country": "Norway",
                            "country_code": "NOR",
                            "abbreviation": "BRA",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:1281",
                            "name": "Broendby IF",
                            "country": "Denmark",
                            "country_code": "DNK",
                            "abbreviation": "BRO",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:1284",
                            "name": "FC Copenhagen",
                            "country": "Denmark",
                            "country_code": "DNK",
                            "abbreviation": "FCC",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:1759",
                            "name": "Djurgardens IF",
                            "country": "Sweden",
                            "country_code": "SWE",
                            "abbreviation": "DJU",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:1760",
                            "name": "Hacken Gothenburg",
                            "country": "Sweden",
                            "country_code": "SWE",
                            "abbreviation": "HAC",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:1899",
                            "name": "Valur Reykjavik",
                            "country": "Iceland",
                            "country_code": "ISL",
                            "abbreviation": "VAL",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:1901",
                            "name": "Breidablik Kopavogur",
                            "country": "Iceland",
                            "country_code": "ISL",
                            "abbreviation": "KOP",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:1908",
                            "name": "Vikingur Reykjavik",
                            "country": "Iceland",
                            "country_code": "ISL",
                            "abbreviation": "VIK",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:1912",
                            "name": "Stjarnan Gardabae",
                            "country": "Iceland",
                            "country_code": "ISL",
                            "abbreviation": "STJ",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:1926",
                            "name": "Fehervar FC Szekesfehervar",
                            "country": "Hungary",
                            "country_code": "HUN",
                            "abbreviation": "FEH",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:2036",
                            "name": "HNK Hajduk Split",
                            "country": "Croatia",
                            "country_code": "HRV",
                            "abbreviation": "HAJ",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:2040",
                            "name": "NK Osijek",
                            "country": "Croatia",
                            "country_code": "HRV",
                            "abbreviation": "OSI",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:2203",
                            "name": "FK Austria Wien",
                            "country": "Austria",
                            "country_code": "AUT",
                            "abbreviation": "FAK",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:2204",
                            "name": "FC Banik Ostrava",
                            "country": "Czechia",
                            "country_code": "CZE",
                            "abbreviation": "BAN",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:2224",
                            "name": "FK Mlada Boleslav",
                            "country": "Czechia",
                            "country_code": "CZE",
                            "abbreviation": "MLA",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:2244",
                            "name": "Kuopion Palloseura",
                            "country": "Finland",
                            "country_code": "FIN",
                            "abbreviation": "KUPS",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:2246",
                            "name": "Vaasan Palloseura",
                            "country": "Finland",
                            "country_code": "FIN",
                            "abbreviation": "VPS",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:2359",
                            "name": "St Mirren FC",
                            "country": "Scotland",
                            "country_code": "SCO",
                            "abbreviation": "MIR",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:2406",
                            "name": "FC Spartak Trnava",
                            "country": "Slovakia",
                            "country_code": "SVK",
                            "abbreviation": "TRN",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:2416",
                            "name": "Olimpija Ljubljana",
                            "country": "Slovenia",
                            "country_code": "SVN",
                            "abbreviation": "OLI",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:2420",
                            "name": "NK Maribor",
                            "country": "Slovenia",
                            "country_code": "SVN",
                            "abbreviation": "MAR",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:2442",
                            "name": "FC St. Gallen 1879",
                            "country": "Switzerland",
                            "country_code": "CHE",
                            "abbreviation": "STG",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:2450",
                            "name": "FC Zurich",
                            "country": "Switzerland",
                            "country_code": "CHE",
                            "abbreviation": "FCZ",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:2463",
                            "name": "FC Vaduz",
                            "country": "Switzerland",
                            "country_code": "CHE",
                            "abbreviation": "VAD",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:2903",
                            "name": "KAA Gent",
                            "country": "Belgium",
                            "country_code": "BEL",
                            "abbreviation": "KAA",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:2979",
                            "name": "Go Ahead Eagles",
                            "country": "Netherlands",
                            "country_code": "NLD",
                            "abbreviation": "GAE",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:3009",
                            "name": "Vitoria SC Guimaraes",
                            "country": "Portugal",
                            "country_code": "PRT",
                            "abbreviation": "VIT",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:3086",
                            "name": "Istanbul Basaksehir",
                            "country": "Turkiye",
                            "country_code": "TUR",
                            "abbreviation": "BAS",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:3106",
                            "name": "Legia Warszawa",
                            "country": "Poland",
                            "country_code": "POL",
                            "abbreviation": "LEG",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:3108",
                            "name": "WKS Slask Wroclaw",
                            "country": "Poland",
                            "country_code": "POL",
                            "abbreviation": "SLA",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:3169",
                            "name": "Saint Patrick´s Athletic FC",
                            "country": "Ireland",
                            "country_code": "IRL",
                            "abbreviation": "STP",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:3170",
                            "name": "Derry City FC",
                            "country": "Ireland",
                            "country_code": "IRL",
                            "abbreviation": "DER",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:3174",
                            "name": "Shelbourne FC",
                            "country": "Ireland",
                            "country_code": "IRL",
                            "abbreviation": "SHE",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:3250",
                            "name": "AEK Athens",
                            "country": "Greece",
                            "country_code": "GRC",
                            "abbreviation": "AEK",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:3280",
                            "name": "PFC Cherno More Varna",
                            "country": "Bulgaria",
                            "country_code": "BGR",
                            "abbreviation": "CMV",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:3342",
                            "name": "FCI Levadia Tallinn",
                            "country": "Estonia",
                            "country_code": "EST",
                            "abbreviation": "LEV",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:3346",
                            "name": "Flora Tallinn",
                            "country": "Estonia",
                            "country_code": "EST",
                            "abbreviation": "FLO",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:3356",
                            "name": "FC Neman Grodno",
                            "country": "Belarus",
                            "country_code": "BLR",
                            "abbreviation": "NEM",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:3359",
                            "name": "FC Torpedo Belaz Zhodino",
                            "country": "Belarus",
                            "country_code": "BLR",
                            "abbreviation": "TOR",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:3395",
                            "name": "AC Omonia Nicosia",
                            "country": "Cyprus",
                            "country_code": "CYP",
                            "abbreviation": "OMO",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:3404",
                            "name": "AEK Larnaca",
                            "country": "Cyprus",
                            "country_code": "CYP",
                            "abbreviation": "AEK",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:4909",
                            "name": "Caernarfon Town FC",
                            "country": "Wales",
                            "country_code": "WAL",
                            "abbreviation": "CAT",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:4912",
                            "name": "Connah's Quay Nomads FC",
                            "country": "Wales",
                            "country_code": "WAL",
                            "abbreviation": "CQN",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:5143",
                            "name": "FK Buducnost",
                            "country": "Montenegro",
                            "country_code": "MNE",
                            "abbreviation": "BUD",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:5171",
                            "name": "FC Dinamo Tbilisi",
                            "country": "Georgia",
                            "country_code": "GEO",
                            "abbreviation": "TBI",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:5178",
                            "name": "HSK Zrinjski Mostar",
                            "country": "Bosnia & Herzegovina",
                            "country_code": "BIH",
                            "abbreviation": "ZRI",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:5180",
                            "name": "Crusaders FC",
                            "country": "Northern Ireland",
                            "country_code": "NIR",
                            "abbreviation": "CRU",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:5181",
                            "name": "Cliftonville FC",
                            "country": "Northern Ireland",
                            "country_code": "NIR",
                            "abbreviation": "CLI",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:5185",
                            "name": "B36 Torshavn",
                            "country": "Faroe Islands",
                            "country_code": "FRO",
                            "abbreviation": "B36",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:5187",
                            "name": "HB Torshavn",
                            "country": "Faroe Islands",
                            "country_code": "FRO",
                            "abbreviation": "HB",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:5193",
                            "name": "Vikingur Gota",
                            "country": "Faroe Islands",
                            "country_code": "FRO",
                            "abbreviation": "VIK",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:5195",
                            "name": "KF Tirana",
                            "country": "Albania",
                            "country_code": "ALB",
                            "abbreviation": "KFT",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:5197",
                            "name": "Maccabi Haifa FC",
                            "country": "Israel",
                            "country_code": "ISR",
                            "abbreviation": "MAH",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:5202",
                            "name": "Hapoel Be`er Sheva FC",
                            "country": "Israel",
                            "country_code": "ISR",
                            "abbreviation": "HBS",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:5206",
                            "name": "Sliema Wanderers",
                            "country": "Malta",
                            "country_code": "MLT",
                            "abbreviation": "SLI",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:5207",
                            "name": "F91 Dudelange",
                            "country": "Luxembourg",
                            "country_code": "LUX",
                            "abbreviation": "F91",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:5214",
                            "name": "FC Pyunik Yerevan",
                            "country": "Armenia",
                            "country_code": "ARM",
                            "abbreviation": "PYU",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:5222",
                            "name": "Partizani Tirana",
                            "country": "Albania",
                            "country_code": "ALB",
                            "abbreviation": "PTI",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:5225",
                            "name": "FC Urartu Yerevan",
                            "country": "Armenia",
                            "country_code": "ARM",
                            "abbreviation": "URA",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:5237",
                            "name": "FK Sarajevo",
                            "country": "Bosnia & Herzegovina",
                            "country_code": "BIH",
                            "abbreviation": "FKS",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:5265",
                            "name": "FC Zimbru Chisinau",
                            "country": "Moldova",
                            "country_code": "MDA",
                            "abbreviation": "ZIM",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:5272",
                            "name": "Linfield FC",
                            "country": "Northern Ireland",
                            "country_code": "NIR",
                            "abbreviation": "LIN",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:5287",
                            "name": "FC CFR 1907 Cluj",
                            "country": "Romania",
                            "country_code": "ROU",
                            "abbreviation": "CFR",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:5345",
                            "name": "Vilnius FK Zalgiris",
                            "country": "Lithuania",
                            "country_code": "LTU",
                            "abbreviation": "ZAL",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:5346",
                            "name": "FK Auda Riga",
                            "country": "Latvia",
                            "country_code": "LVA",
                            "abbreviation": "AUD",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:5355",
                            "name": "FC Aktobe",
                            "country": "Kazakhstan",
                            "country_code": "KAZ",
                            "abbreviation": "AKT",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:5362",
                            "name": "Tobol Kostanay",
                            "country": "Kazakhstan",
                            "country_code": "KAZ",
                            "abbreviation": "TOB",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:5366",
                            "name": "FC Ordabasy",
                            "country": "Kazakhstan",
                            "country_code": "KAZ",
                            "abbreviation": "ORD",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:5413",
                            "name": "Shkendija Tetovo",
                            "country": "North Macedonia",
                            "country_code": "MKD",
                            "abbreviation": "SHK",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:5418",
                            "name": "Vllaznia Shkoder",
                            "country": "Albania",
                            "country_code": "ALB",
                            "abbreviation": "KFV",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:5419",
                            "name": "FC Torpedo Kutaisi",
                            "country": "Georgia",
                            "country_code": "GEO",
                            "abbreviation": "TKU",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:6059",
                            "name": "Paksi FC",
                            "country": "Hungary",
                            "country_code": "HUN",
                            "abbreviation": "PAK",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:6151",
                            "name": "FK Velez Mostar",
                            "country": "Bosnia & Herzegovina",
                            "country_code": "BIH",
                            "abbreviation": "VEL",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:6226",
                            "name": "FK Decic Tuzi",
                            "country": "Montenegro",
                            "country_code": "MNE",
                            "abbreviation": "TUZ",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:7105",
                            "name": "JK Tallinna Kalev",
                            "country": "Estonia",
                            "country_code": "EST",
                            "abbreviation": "KAL",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:7605",
                            "name": "FC Differdange 03",
                            "country": "Luxembourg",
                            "country_code": "LUX",
                            "abbreviation": "DIF",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:7704",
                            "name": "Marsaxlokk FC",
                            "country": "Malta",
                            "country_code": "MLT",
                            "abbreviation": "MAR",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:22386",
                            "name": "Tampereen Ilves",
                            "country": "Finland",
                            "country_code": "FIN",
                            "abbreviation": "ILV",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:23833",
                            "name": "DAC 1904 Dunajska Streda",
                            "country": "Slovakia",
                            "country_code": "SVK",
                            "abbreviation": "DDS",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:32476",
                            "name": "Paide Linnameeskond",
                            "country": "Estonia",
                            "country_code": "EST",
                            "abbreviation": "PAI",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:33583",
                            "name": "Hamrun Spartans FC",
                            "country": "Malta",
                            "country_code": "MLT",
                            "abbreviation": "HAM",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:33584",
                            "name": "Floriana FC",
                            "country": "Malta",
                            "country_code": "MLT",
                            "abbreviation": "FLO",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:36019",
                            "name": "FK Mornar Bar",
                            "country": "Montenegro",
                            "country_code": "MNE",
                            "abbreviation": "MBA",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:36155",
                            "name": "FC Astana",
                            "country": "Kazakhstan",
                            "country_code": "KAZ",
                            "abbreviation": "FCA",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:36201",
                            "name": "FC Progres Niederkorn",
                            "country": "Luxembourg",
                            "country_code": "LUX",
                            "abbreviation": "NIE",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:36255",
                            "name": "Bala Town FC",
                            "country": "Wales",
                            "country_code": "WAL",
                            "abbreviation": "BAT",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:36261",
                            "name": "AC Virtus",
                            "country": "San Marino",
                            "country_code": "SMR",
                            "abbreviation": "VIR",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:37297",
                            "name": "FC Dinamo Batumi",
                            "country": "Georgia",
                            "country_code": "GEO",
                            "abbreviation": "BAT",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:37860",
                            "name": "SP La Fiorita",
                            "country": "San Marino",
                            "country_code": "SMR",
                            "abbreviation": "LAF",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:37862",
                            "name": "SP Tre Penne",
                            "country": "San Marino",
                            "country_code": "SMR",
                            "abbreviation": "TRP",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:37946",
                            "name": "Inter Club de Escaldes",
                            "country": "Andorra",
                            "country_code": "AND",
                            "abbreviation": "ESC",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:37962",
                            "name": "Atletic Club d'Escaldes",
                            "country": "Andorra",
                            "country_code": "AND",
                            "abbreviation": "ATL",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:42965",
                            "name": "FC Isloch",
                            "country": "Belarus",
                            "country_code": "BLR",
                            "abbreviation": "ISL",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:43576",
                            "name": "GFK Tikvesh 1930",
                            "country": "North Macedonia",
                            "country_code": "MKD",
                            "abbreviation": "GFK",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:43981",
                            "name": "FK Radnicki 1923 Kragujevac",
                            "country": "Serbia",
                            "country_code": "SRB",
                            "abbreviation": "RAD",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:44497",
                            "name": "Sumgayit FK",
                            "country": "Azerbaijan",
                            "country_code": "AZE",
                            "abbreviation": "SUM",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:46353",
                            "name": "FC Una Strassen",
                            "country": "Luxembourg",
                            "country_code": "LUX",
                            "abbreviation": "UNA",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:53475",
                            "name": "FC Milsami",
                            "country": "Moldova",
                            "country_code": "MDA",
                            "abbreviation": "MIL",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:116223",
                            "name": "CS Universitatea Craiova",
                            "country": "Romania",
                            "country_code": "ROU",
                            "abbreviation": "CSU",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:116312",
                            "name": "FC Iberia 1999",
                            "country": "Georgia",
                            "country_code": "GEO",
                            "abbreviation": "IBE",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:126312",
                            "name": "St Joseph`s FC",
                            "country": "Gibraltar",
                            "country_code": "GIB",
                            "abbreviation": "STJ",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:146336",
                            "name": "FK Liepaja",
                            "country": "Latvia",
                            "country_code": "LVA",
                            "abbreviation": "LIE",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:162368",
                            "name": "Riga FC",
                            "country": "Latvia",
                            "country_code": "LVA",
                            "abbreviation": "RFC",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:171626",
                            "name": "Pafos FC",
                            "country": "Cyprus",
                            "country_code": "CYP",
                            "abbreviation": "PAF",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:173406",
                            "name": "Zira FK",
                            "country": "Azerbaijan",
                            "country_code": "AZE",
                            "abbreviation": "ZIR",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:277835",
                            "name": "KF Drita",
                            "country": "Kosovo",
                            "country_code": "KOS",
                            "abbreviation": "DRI",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:277847",
                            "name": "KF Llapi",
                            "country": "Kosovo",
                            "country_code": "KOS",
                            "abbreviation": "LAP",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:280003",
                            "name": "FC Ballkani",
                            "country": "Kosovo",
                            "country_code": "KOS",
                            "abbreviation": "BAL",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:288687",
                            "name": "FC CSKA 1948",
                            "country": "Bulgaria",
                            "country_code": "BGR",
                            "abbreviation": "CSK",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:299146",
                            "name": "FC Struga Trim Lum",
                            "country": "North Macedonia",
                            "country_code": "MKD",
                            "abbreviation": "STL",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:340394",
                            "name": "FCB Magpies",
                            "country": "Gibraltar",
                            "country_code": "GIB",
                            "abbreviation": "FCB",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:350828",
                            "name": "FC Polissya Zhytomyr",
                            "country": "Ukraine",
                            "country_code": "UKR",
                            "abbreviation": "POL",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:362744",
                            "name": "Bravo Ljubljana",
                            "country": "Slovenia",
                            "country_code": "SVN",
                            "abbreviation": "BRA",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:364472",
                            "name": "FC Ararat-Armenia",
                            "country": "Armenia",
                            "country_code": "ARM",
                            "abbreviation": "ARA",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:364474",
                            "name": "FC Noah Yerevan",
                            "country": "Armenia",
                            "country_code": "ARM",
                            "abbreviation": "FCN",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:372056",
                            "name": "KF Egnatia Rrogozhine",
                            "country": "Albania",
                            "country_code": "ALB",
                            "abbreviation": "EGR",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:382568",
                            "name": "Sabah Masazir",
                            "country": "Azerbaijan",
                            "country_code": "AZE",
                            "abbreviation": "SBH",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:557322",
                            "name": "FA Siauliai",
                            "country": "Lithuania",
                            "country_code": "LTU",
                            "abbreviation": "SIA",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:617264",
                            "name": "KF Malisheva",
                            "country": "Kosovo",
                            "country_code": "KOS",
                            "abbreviation": "MAL",
                            "gender": "male"
                        },
                        {
                            "id": "sr:competitor:885005",
                            "name": "FK Transinvest",
                            "country": "Lithuania",
                            "country_code": "LTU",
                            "abbreviation": "TRA",
                            "gender": "male"
                        }
                    ],
                    "coverage": {
                        "type": "group",
                        "group_properties": {
                            "brackets": true,
                            "cup": true,
                            "league": false,
                            "missing_players": false,
                            "qualification": true,
                            "schedules": true,
                            "results": true,
                            "standings": "false",
                            "group_stage": false
                        },
                        "sport_event_properties": {
                            "basic_play_by_play": false,
                            "basic_player_stats": false,
                            "basic_team_stats": false,
                            "lineups": false,
                            "extended_player_stats": false,
                            "extended_team_stats": false,
                            "deeper_team_stats": false,
                            "deeper_player_stats": false,
                            "deeper_play_by_play": false,
                            "goal_scorers": true,
                            "scores": "live"
                        }
                    }
                }
            ]
        }
    ]
}

How do you define Team Statistics and Player Statistics as `sport_event_properties` in terms of coverage?

Team Statistics:

basic_team_stats: yellow_cards, yellow_red_cards, red_cards.
deeper_team_stats: corner_kicks, shots_total, shots_on_target, shots_off_target, shots_blocked, ball_possession, free_kicks, offsides, goal_kicks, throw_ins, shots_saved, fouls, and injuries.

Player Statistics:

basic_player_stats: goals_scored, yellow_cards, yellow_red_cards, red_cards, own_goals, assists, substituted_in, and substituted_out.
deeper_player_stats: offsides, corner_kicks, shots_on_target, shots_off_target, and shots_blocked.

Why does the coverage of a cup competition not match the data?

For cup competitions, coverage levels may vary from the early rounds to latter stages. Coverage properties are set at a competition level and display the best coverage we offer for a sport event in this competition.

Why is `goals_scored` the only statistic available in Season Leaders and Season Competitor Statistics for some competitions?

This is determined by the assists="false" property in the Season Info feed which indicates that stats below goals_scored are not guaranteed for the competition in question.

<sport_event_properties basic_play_by_play="false" basic_player_stats="false" basic_team_stats="false" 
extended_player_stats="false" extended_team_stats="false" deeper_play_by_play="false" deeper_team_stats="false" 
deeper_player_stats="false" lineups="false" goal_scorers="false" scores="live" assists="false"/>

Why do properties for all matches adjust during Cup Competitions?

Some of our settings are updated on the Competition level only. Using formations as an example, this is not available for the 1st round of a competition and will therefore be set to false. When formation becomes available for the Quarterfinals, the property updates to true for all matches.

Integration

How can I find the values for various enum data points within the API?

Many enum values are listed in the FAQ below. For the most up-to-date values, please see the Schema section of the OpenAPI specification here

What format are date fields presented in?

Date values are presented in the ISO 8601 standard format.

Timestamp fields are in UTC. These could include scheduled start times or play-by-play event timestamps. Examples: scheduled="2024-02-11T23:30:00+00:00", created_at="2024-02-11T23:43:20+00:00"

Date-only fields reflect local league convention and are not UTC-adjusted. These could include season start dates and birth dates. Examples: start_date="2024-08-16", date_of_birth="1984-09-22"

How do I locate the TTL (Time to Live)/cache on an API endpoint?

The cache (in seconds) can be accessed in the returned header information on each RESTful API call, under cache-control.

ex. cache-control: max-age=1, public, s-maxage=1 or cache-control: public, must-revalidate, max-age=120

Sport Event Statuses

What are the valid `sport_event_status` – `status` values?

What are the valid `sport_event_status` – `match_status` values?

Event & Period Types

What are the possible event types?

break_start
canceled_decision_to_var
corner_kick
cross
decision_to_var
decision_to_var_over
dribble
free_kick
foul
goal_kick
goal_prevented_by
injury
injury_return
injury_time_shown
interception
match_ended
match_started
offside
pass
penalty_awarded
penalty_kick
penalty_missed
penalty_shootout
period_score
period_start
player_back_from_injury
possible_decision_to_var
possible_goal
red_card
save
score_change
shot_on_target
shot_off_target
shot_saved
substitution
tackle
throw_in
video_assistant_referee
video_assistant_referee_over
yellow_card
yellow_red_card

Availability of Video Assistant Referee is subject to the VAR capabilities of the league.

What are the possible `event.period_type` values?

regular_period — The match is in a regular period
overtime — The match is in overtime
penalties — The match is in penalties
pause — The match is paused
awaiting_extra — The match is awaiting extra time
awaiting_penalties — The match is awaiting penalties
extra_time_halftime — The match is in halftime of extra time
interrupted — The match is interrupted

<event id="1721757571" type="match_started" time="2024-04-16T19:01:48+00:00"/>
  <event id="1721757569" type="period_start" time="2024-04-16T19:01:48+00:00" period="1" period_type="regular_period" period_name="regular_period"/>
    <event id="1721758935" type="free_kick" time="2024-04-16T19:03:37+00:00" match_time="2" match_clock="1:49" competitor="away" x="49" y="18" period="1" period_type="regular_period">
      <players>
      <player id="sr:player:138156" name="Can, Emre"/>
        </players>
<commentaries>
        <commentary text="Free kick Atletico."/>
          </commentaries>
</event>
<event id="1721759321" type="throw_in" time="2024-04-16T19:04:08+00:00" match_time="3" match_clock="2:20" competitor="home" x="26" y="0" period="1" period_type="regular_period">
  <commentaries>
  <commentary text="Slavko Vincic awards the home team a throw-in."/>
    </commentaries>
</event>

"timeline": [
  {
    "id": 1721757571,
    "type": "match_started",
    "time": "2024-04-16T19:01:48+00:00"
  },
  {
    "id": 1721757569,
    "type": "period_start",
    "time": "2024-04-16T19:01:48+00:00",
    "period": 1,
    "period_type": "regular_period",
    "period_name": "regular_period"
  },
  {
    "id": 1721758935,
    "type": "free_kick",
    "time": "2024-04-16T19:03:37+00:00",
    "match_time": 2,
    "match_clock": "1:49",
    "competitor": "away",
    "players": [
      {
        "id": "sr:player:138156",
        "name": "Can, Emre"
      }
    ],
    "x": 49,
    "y": 18,
    "period": 1,
    "period_type": "regular_period",
    "commentaries": [
      {
        "text": "Free kick Atletico."
      }
    ]
  },
  {
    "id": 1721759321,
    "type": "throw_in",
    "time": "2024-04-16T19:04:08+00:00",
    "match_time": 3,
    "match_clock": "2:20",
    "competitor": "home",
    "x": 26,
    "y": 0,
    "period": 1,
    "period_type": "regular_period",
    "commentaries": [
      {
        "text": "Slavko Vincic awards the home team a throw-in."
      }
    ]
  },
  {
    "id": 1721760077,
    "type": "shot_on_target",
    "time": "2024-04-16T19:05:15+00:00",
    "match_time": 4,
    "match_clock": "3:26",
    "competitor": "home",
    "players": [
      {
        "id": "sr:player:862396",
        "name": "Ryerson, Julian"
      }
    ],
    "x": 95,
    "y": 76,
    "period": 1,
    "period_type": "regular_period",
    "commentaries": [
      {
        "text": "Julian Ryerson of Dortmund smashes in a shot on target. The keeper saves, though."
      }
    ]
  },
  {
    "id": 1721760083,
    "type": "shot_saved",
    "time": "2024-04-16T19:05:15+00:00",
    "match_time": 4,
    "match_clock": "3:26",
    "competitor": "away",
    "period": 1,
    "period_type": "regular_period"
  },

Which Timeline event types can be associated with a player?

corner_kick
injury
injury_return
offside
penalty_awarded
penalty_kick
penalty_missed
penalty_shootout
player_back_from_injury
red_card
score_change
shot_off_target
shot_on_target
substitution
yellow_card
yellow_red_card

<event id="1721787551" type="yellow_card" time="2024-04-16T19:47:26+00:00" match_time="45" match_clock="45:00" 
       competitor="away" stoppage_time="1" stoppage_time_clock="0:37" period="1" period_type="regular_period">
  <players>
    <player id="sr:player:353130" name="Hermoso, Mario"/>
  </players>
  <commentaries>
    <commentary text="Mario Hermoso (Atletico) has received a yellow card from Slavko Vincic."/>
  </commentaries>
</event>

{
  "id": 1721787305,
  "type": "injury_time_shown",
  "time": "2024-04-16T19:46:54+00:00",
  "match_time": 45,
  "match_clock": "45:00",
  "stoppage_time": 1,
  "stoppage_time_clock": "0:05",
  "period": 1,
  "period_type": "regular_period",
  "injury_time_announced": 2
},
{
  "id": 1721787551,
  "type": "yellow_card",
  "time": "2024-04-16T19:47:26+00:00",
  "match_time": 45,
  "match_clock": "45:00",
  "competitor": "away",
  "players": [
    {
      "id": "sr:player:353130",
      "name": "Hermoso, Mario"
    }
  ],
  "stoppage_time": 1,
  "stoppage_time_clock": "0:37",
  "period": 1,
  "period_type": "regular_period",
  "commentaries": [
    {
      "text": "Mario Hermoso (Atletico) has received a yellow card from Slavko Vincic."
    }
  ]
},

How does the `possible_goal` event type work?

This event will occur immediately if one team scores a goal or if they are in a very clear scoring opportunity (1-on-1 with the goalkeeper, clear shot at an empty net, etc).

<event id="2167869680" type="possible_goal" time="2025-10-16T16:13:56+00:00" match_time="54" match_clock="53:36" competitor="home" period="2" period_type="regular_period"/>
<event id="2167869794" type="score_change" time="2025-10-16T16:14:05+00:00" match_time="54" match_clock="53:36" competitor="home" x="90" y="66" period="2" period_type="regular_period" home_score="1" away_score="0">
          <players>
              <player id="sr:player:1988141" name="Stjopin, Maksim" type="scorer"/>
          </players>
          <commentaries>
              <commentary text="Goal! Ilves have got their heads in front thanks to a Maksim Stjopin strike."/>
          </commentaries>
</event>

Pagination

How can I tell if an endpoint is paginated?

To determine if a RESTful API endpoint uses pagination, visit the endpoint's page on our developer portal, its OpenAPI specification, or check the X-Result and X-Max-Results headers in the API response.

X-Result: This header indicates the number of items returned for this request.
X-Max-Results: This header specifies the total number of items available for a specified request.

If both headers are present and the response data is truncated (i.e., X-Result value is less than X-Max-Results), you can infer that pagination is in use. To fetch the remaining data, make use of the limit and start query string parameters.

In the below Season Summary response, the header specifies 100 sports events are returned (x-result), but 381 sport events are available (x-max-results). Make an additional API request – such as appending &start=100 to the end of your call – to obtain additional events.

< HTTP/2 200 
< content-type: application/json
< content-length: 1725369
< date: Wed, 13 Nov 2024 21:06:18 GMT
< x-amzn-requestid: c10fe405-ce81-46fb-a3db-38d153dd2a6c
< x-offset: 0
< x-amz-apigw-id: BNAvVGCUliAEKJA=
< cache-control: max-age=300, public, s-maxage=300
< x-result: 100
< etag: "341dc78002bc578c62a6878519ba0404"
< x-max-results: 381
< link: <https://schemas.sportradar.com/sportsapi/soccer/v4/schemas/season_summaries.json#>; rel="describedBy"
< x-amzn-trace-id: Root=1-673514c8-7a887f81636af0110ecce2d3
< x-amzn-remapped-date: Wed, 13 Nov 2024 21:06:17 GMT
< vary: Accept-Encoding
< x-cache: Hit from cloudfront
< via: 1.1 f2f0cb8191da3bf07a9ca31ece94ab68.cloudfront.net (CloudFront)
< x-amz-cf-pop: IAD61-P4
< x-amz-cf-id: 1cyji-XQZuBlAUsR8QoHdNLWD-jn1HvBC-ShaCMhXl5mMDiFTDRVyQ==
< age: 16

Why can't I find a particular match in the Daily Summaries, Season Summaries or Sport Events Updated endpoints?

These endpoints support pagination and return a select number of results by default. To return more matches, include an additional query string parameter. Visit an endpoint page for minimum and maximum result values.

Probabilities

What is the Probabilities package?

The Probabilities package is an add-on set of feeds that are an extension of the Season Probabilities feed in the main package (which already provides pre-match probabilities for the sport event winner market).

The main features of the Probabilities extension are: Live Probabilities that update throughout game, Season Outright Probabilities for the Tournament Winner market, and Live Probabilities Coverage indicator for the next 24 hours.

Is there Live Probability coverage for every game you cover in the Soccer API?

Live Probability coverage depends on a number of factors and we can’t guarantee that every game will be covered for any given league. However, Sportradar covers tens of thousands of sport events across hundreds of leagues.

For individual competition coverage, contact sales@sportradar.com

What are markets, and which ones are available?

A market represents a betting option for which we provide probability data. Over time, additional markets may be added to the API.

Currently, we offer one market: 3-way, which indicates the probability of each possible outcome — home win, away win, or draw.

What are the valid outcomes for probabilities?

home_team_winner
away_team_winner
draw

Lineups / Rosters

When does the Lineups Availability update?

The lineups_availability data is updated 30 days before the sport event is scheduled to begin.

When will lineups confirmed show as true?

Lineups information displays as it is entered. Once complete, we confirm lineups and the lineups_confirmed attribute updates to true. This only appears for matches with lineups_availability="pre".

What are the possible values for `sport_event_properties` – `lineups_availability` in the Summary and Timeline endpoints?

pre
post

What are the valid lineup types (player position) values?

goalkeeper
defender
midfielder
forward

What are the valid lineups descriptions (player tactical position) values?

goalkeeper
right back
central defender
left back
right winger
central midfielder
left winger
striker

How is the order value in the Lineups endpoint organized?

Order number 1 is always the goalie (star marking) and formations as well as numbering should start with the goalkeeper.

In the example diagram the formation 4-2-3-1 is used.

4 is the number of players in the line in front of the goalkeeper, then comes the line with 2 players and so on.

Numbering in every line starts at the right-hand side of the goalkeeper – this causes the numbering to be mirrored for the home and away team.

Do you have player transfer and on-loan data available?

Transfers

We use roles from player profiles to create a Season Transfers endpoint. This displays any player recently assigned to a team in a season covered with player_transfer_history="true".

Transfers can include youth players recently added to a matchday squad. If there is no previous club within 10 days, then this will be understood to be a free agent and therefore no from_competitor will display.

For transfer_date, we use multiple sources and cannot guarantee the accuracy.

Sample Snippet (Season Transfers)

 <transfer transfer_date="2025-09-01" role_type="player" from_competitor="sr:competitor:1681" to_competitor="sr:competitor:7">
    <player id="sr:player:2839263" name="Canvot, Jaydee" type="defender" date_of_birth="2006-07-29" nationality="France" country_code="FRA" height="188" weight="75" jersey_number="23" preferred_foot="right" place_of_birth="Argenteuil"/>
        <competitors>
        <competitor id="sr:competitor:1681" name="Toulouse FC" country="France" country_code="FRA" abbreviation="TFC" gender="male"/>
            <competitor id="sr:competitor:7" name="Crystal Palace" country="England" country_code="ENG" abbreviation="CRY" gender="male"/>
            </competitors>
</transfer>
<transfer transfer_date="2025-09-01" role_type="on_loan" from_competitor="sr:competitor:2859" to_competitor="sr:competitor:7">
    <player id="sr:player:2801755" name="Uche, Christantus" type="midfielder" date_of_birth="2003-05-19" nationality="Nigeria" country_code="NGA" height="190" weight="84" jersey_number="10" preferred_foot="both" place_of_birth="Owerri (NIGERIA)"/>
        <competitors>
        <competitor id="sr:competitor:2859" name="Getafe CF" country="Spain" country_code="ESP" abbreviation="GET" gender="male"/>
            <competitor id="sr:competitor:7" name="Crystal Palace" country="England" country_code="ENG" abbreviation="CRY" gender="male"/>
            </competitors>
</transfer>

On-Loan

Players on loan to other teams appear in the Competitor Profile and Seasonal Competitor Players endpoints for their teams. They are identified using the following attributes:

on_loan — Boolean value signifying a player is on loan to this team (parent competitor) when true
loaned_to_competitor_id— The unique ID of the competitor (team) the player is currently loaned to (for example, sr:competitor:9)

Sample Snippets

  {
    "id": "sr:player:552632",
    "name": "Manuel, Benson",
    "type": "forward",
    "date_of_birth": "1997-03-28",
    "nationality": "Angola",
    "country_code": "AGO",
    "height": 178,
    "weight": 68,
    "jersey_number": 26,
    "preferred_foot": "left",
    "gender": "male",
    "loaned_to_competitor_id": "sr:competitor:74"
  },

  <player id="sr:player:927018" name="Krejci, Ladislav" type="defender" date_of_birth="1999-04-20" nationality="Czech republic" country_code="CZE" height="191" weight="70" jersey_number="37" preferred_foot="left" place_of_birth="Rosice" on_loan="true"/>

What are the possible reasons for a player to appear in the Missing Players endpoint?

injured
ill
other
suspension

Ball Location

How does the ball location attribute work?

Our scouts mark down the x (lateral) and y (longitudinal) coordinates as observed on the pitch. The data can come in sporadically as events on the field play out, but new ball_location data is potentially available every 1 second. This is only available for matches with ballspotting="true".

The element ball_locations stores the last four known ball locations, after which the data is not available unless it corresponds with another event in the timeline such as throw_in or shot_on_goal. The ball_location order illustrates the most recent location as 4 and the oldest location as 1.

<ball_locations>
  <ball_location order="4" x="14" y="100" qualifier="home"/>
  <ball_location order="3" x="7" y="89" qualifier="away"/>
  <ball_location order="2" x="31" y="77" qualifier="away"/>
  <ball_location order="1" x="66" y="50" qualifier="away"/>
</ball_locations>

What is the scale of the X Y coordinates?

The pitch we use is 100 by 100. Here is a layout of the pitch:

x = Horizontal position on the pitch. X is a number between 0 and 100. The reference point 0 is at the home team’s goal.

y = Vertical position on the pitch. Y is a number between 0 and 100. The reference point 0 is on the top of the pitch where the home team’s goal is on the left hand side.

A, B, C, D = Penalty box edge coordinates. The coordinates start from 0 on the home team side and end with 100 on the away team side.

Note: The home team always attacks from left to right in the data feed, and the away team from right to left. They do not switch at halftime.

What are the possible values for match situation status (`match_situation.status`)?

Listed below are the values and definitions for match_situation - status. These can be leveraged to determine the status of a ball in play.

safe - Team in possession of the ball is inside their defensive half
dangerous - Team in possession is in the opponent’s half but not near the penalty box
attack - Team in possession is in the opponent’s half, near the penalty box

Past Season Data

Why does the coverage of past seasons not match the data?

Coverage properties are set at a competition level and only reflect the current or last season of that competition. Previous seasons may have greater or lesser coverage.

How long is full match data available in the API?

Match data is archived after one year and you will only be able to service basic score information from the API.

A historical statistics API for Soccer is on the roadmap, but no ETA is available at this time.

How are seasonal competitor statistics handled?

Statistics from any qualification rounds will not be displayed. The feed will only display data from the main competition.

Standings / Tournaments

Apertura / Clausura Season Structure Changes

What is changing?

Starting with select competitions from the 2026 and 2026/27 seasons, competitions that currently operate with separate Apertura and Clausura seasons will be restructured into a single season in the Soccer API.

Under the new structure:

Apertura and Clausura will be represented as stages within a single season
The overall competition and season will remain consistent, with stages used to distinguish Apertura and Clausura phases

This change is being made to ensure greater consistency across competition and season modeling within the Soccer API.

When does this change take effect?

From the 2026 season for select competitions
From the 2026/27 season for additional competitions (see list below)
No changes are expected for seasons prior to these effective dates.

Which competitions are affected?

From the 2026 season

Argentina – Liga Profesional de Fútbol
Colombia – Primera A
Paraguay – División de Honor
Panama – Liga Panameña

From the 2026/27 season

Costa Rica – Primera División
Costa Rica – Liga de Ascenso
El Salvador – Primera División
Guatemala – Liga Nacional
Honduras – Liga Nacional
Mexico – Liga MX
Mexico – Liga de Expansión
Mexico – Liga MX Women

Are historical seasons affected?

No.

All previous seasons will remain unchanged and will continue to be represented using the existing structure. This update only applies to seasons starting in 2026 or later, depending on the competition.

Are historical seasons affected?

If your integration:

Treats Apertura and Clausura as separate seasons, or
Relies on season-level identifiers to distinguish between Apertura and Clausura

You may need to:

Update logic to reference stages within a season instead of separate seasons
Review how season and stage data is consumed for affected competitions

If your integration already supports stages, minimal or no changes may be required.

Will competition or team data change?

No changes are expected to:

Competition identifiers
Team identifiers
Match data content

The change is limited to how Apertura and Clausura are organized within the season structure.

Why is this change being made?

This update aligns Apertura and Clausura competitions with a more consistent season and stage model across the Soccer API, making competition structures easier to interpret and maintain long-term.

Where can I get more information or assistance?

If you have questions about how this change may affect your integration, please contact Sportradar Support or reach out to your account representative.

What are the valid standings types in the Standings endpoint?

total
home
away
first_half_total
first_half_home
first_half_away
second_half_total
second_half_home
second_half_away

What are the possible values for `stage` – `phase`?

1st_part_of_season_1st_leg
2nd_part_of_season_2nd_leg
3rd_round
champions_round
conference
division
final_eight
final_four
final_phase
final_round
final_stage
grand_final
grand_finals
group_phase_1
group_phase_2
knockout_stage
main_round_1
main_round_2
none
placement_matches
placement_matches_13_to_16
placement_matches_5_to_8
placement_matches_9_to_12
placement_matches_9_to_16
playoffs
playout
pre-season
preliminary_round
president_cup
promotion_playoffs
promotion_round
qualification
qualification_playoffs
qualification_to_allsvenskan
regular season
relegation_playoffs
relegation_promotion
relegation_promotion_round
relegation_round
stage_1
stage_1 no_stats
stage_2
stage_2 no_stats
stage_3
uefa_europa_league_playoffs

What are the possible values for `cup_round` – `state` in the Season Links endpoint?

Listed below are the values and definitions for cup_round - state. These can be leveraged to determine the status of a cup round.

empty - A matchup has been created but neither the match details nor the competitors are known.
unseeded_fixture - Match details are known but competitors are unknown.
partial_seeded - One competitor is known.
partial_seeded_fixture - Match details and one competitor are known.
seeded - Both competitors are known.
seeded_fixture - Match details and both competitors are known.
unstarted - Match(es) have been added.
on_going - The first match has started.
decided - The last match has ended.
winner - The winner is known.
cancelled – The matchup has been cancelled.

Are Live Standings available?

Live standings are delivered by default in the Season Standings endpoint. Live standings use an automatic set of tiebreaker rules that are calculated based on the scores while matches are in progress.

We recommend adding the parameter live=false to a Season Standings request to retrieve standings when matches are not in progress. This will consider any additional tie-break criteria that a competition may use if competitors are level.

Why does the `change` attribute not update for live standings?

The change attribute is only available post-match and will display movement from the previous gameweek/round.

<standing rank="5" played="16" win="8" loss="4" draw="4" goals_for="23" goals_against="24" goals_diff="-1" 
points="28" current_outcome="Promotion Playoffs" change="1" points_per_game="1.75">
    <competitor id="sr:competitor:21" name="Preston North End" country="England" country_code="ENG" abbreviation="PNE" gender="male" form="DDLWW"/>
</standing>
<standing rank="6" played="16" win="8" loss="6" draw="2" goals_for="27" goals_against="17" goals_diff="10" 
points="26" current_outcome="Promotion Playoffs" change="2" points_per_game="1.63">
    <competitor id="sr:competitor:41" name="Sunderland AFC" country="England" country_code="ENG" abbreviation="SUN" gender="male" form="LLWDW"/>
</standing>
<standing rank="7" played="16" win="7" loss="4" draw="5" goals_for="26" goals_against="17" goals_diff="9" 
points="26" change="-2" points_per_game="1.63">
    <competitor id="sr:competitor:8" name="West Bromwich Albion" country="England" country_code="ENG" abbreviation="WBA" gender="male" form="DWWWL"/>
</standing>

How are group IDs delivered in the stage array with the various types?

With the type of "league" they will have a sr:league prefix. With the type of "cup" they will have a sr:cup prefix.

What are the valid current outcome values?

AFC Champions League
AFC Cup
CAF Confederation Cup
Champions League
Champions League Qualification
Champions Round
Championship Round
Club Championship
Conference League Qualification
Copa Libertadores
Copa Libertadores Qualification
Copa Sudamericana
Cup Winners
Eliminated
European Cup
Final Four
Final Round
Finals
Group Matches
International Competition
Main Round
Next Group Phase
Placement Matches
Playoffs
Preliminary Round
Promotion
Promotion Playoff
Promotion Playoffs
Promotion Round
Qualification Playoffs
Qualified
Qualifying Round
Relegation
Relegation Playoff
Relegation Playoffs
Relegation Round
Semifinal
Top Six
UEFA Conference League
UEFA Conference League Qualification
UEFA Cup
UEFA Cup Qualification
UEFA Europa League
UEFA Europa League Qualification
UEFA Intertoto Cup

How are form standings displayed?

Forms are available in the Season Standings endpoint and the Season Form Standings endpoint, but they are displayed differently.

Season Standings:

Form standings is located under competitor.form. It displays a team's last 5 matches. The oldest match is listed first.

W = Win, L = Loss, D = Draw

ex. form="WLDDW"

Season Form Standings:

Form standings is located under form_standing.form. You may configure the number of matches to return. The most recent is match listed first.

The max limit to display in your request is 10, which will show, for example, played="10", win="8", loss="2". The form will always display a maximum of 6 matches.

W = Win, L = Loss, D = Draw

ex. form="WDDLWW"

Video Assistant Referee (VAR)

Do you cover VAR events?

VAR events are supported with events video_assistant_referee & video_assistant_referee_over. However, we cannot guarantee the accuracy or frequency of these events.

<event id="1579569948" type="video_assistant_referee" time="2023-10-29T15:46:10+00:00" match_time="85" match_clock="84:01" period="2" period_type="regular_period" description="penalty" competitor="away"/>
<event id="1579570270" type="video_assistant_referee_over" time="2023-10-29T15:46:22+00:00" match_time="85" match_clock="84:13" period="2" period_type="regular_period" description="no_penalty" competitor="away"/>

{
  "id": 1579569948,
  "type": "video_assistant_referee",
  "time": "2023-10-29T15:46:10+00:00",
  "match_time": 85,
  "match_clock": "84:01",
  "period": 2,
  "period_type": "regular_period",
  "description": "penalty",
  "competitor": "away"
},
{
  "id": 1579570270,
  "type": "video_assistant_referee_over",
  "time": "2023-10-29T15:46:22+00:00",
  "match_time": 85,
  "match_clock": "84:13",
  "period": 2,
  "period_type": "regular_period",
  "description": "no_penalty",
  "competitor": "away"
},
{
  "id": 1579571486,
  "type": "shot_on_target",
  "time": "2023-10-29T15:47:13+00:00",
  "match_time": 86,
  "match_clock": "85:05",
  "competitor": "away",
  "players": [
    {
      "id": "sr:player:1718666",
      "name": "Elanga, Anthony"
    }
  ],
  "x": 5,
  "y": 69,
  "period": 2,
  "period_type": "regular_period"
},
{
  "id": 1579571528,
  "type": "shot_saved",
  "time": "2023-10-29T15:47:15+00:00",
  "match_time": 86,
  "match_clock": "85:05",
  "competitor": "home",
  "period": 2,
  "period_type": "regular_period"
},

What are the possible `description` values for `video_assistant_referee`?

goal
penalty
red_card
no_red_card
no_penalty
no_goal

What are the possible `description` values for `video_assistant_referee_over`?

goal
penalty
red_card
call_stands
call_overturned
no_goal
no_penalty
no_red_card

What are the possible values for `referee_assistant` type?

first_assistant_referee
second_assistant_referee
fourth_official
video_assistant_referee
first_additional_assistant
second_additional_assistant
third_additional_assistant

Data Point Definitions

How do you define the key data points?

Data Points	Type of Data Point	Definition
Goal	regular	A goal is assigned to a player of the attacking team if his shot taken by foot, head or any other part of the body leads to a score. All attempts are counted. Uncontrolled deflections resulting in a goal will be attributed to the player who kicked the ball, not the player who deflects the ball.
	own goal	When a defender kicks or heads the ball into the defender’s goal with the intent of making a pass to a teammate or of clearing the ball and it is obvious that no other player of the attacking team tried a shot on target, a goal is recorded as an "own goal". An "own goal" counts towards the offensive team's season statistics. No assist shall be given to the attacking team. If an attacking player shots on goal and the defender deflects the ball into the net, in a controlled action it will be deemed an own goal. If two players of the defending team touched the ball, the player who last touched it is the own goal scorer.
Assist	in general	An assist considered to be a contribution by a player which directly helps a teammate to score a goal. In order to be considered for an assist a player needs to have given the last successful pass. However, the last successful pass does not necessarily automatically constitute an assist.
	counted	Includes corners and throw ins A cross by a team member is converted into a goal Passes/crosses, which are slightly deflected and then lead to a team member score a goal
	not counted	Where goals resulting from penalties are concerned, the player who is fouled in the area receives no assist point shot hits the post/bar and then leads to a goal by a team member The goal scorer made considerable self-effort in order to score
Throw-In		If the ball crosses any of the side lines by its diameter, the game will continue with a throw-in.
Free kicks	team statistics	In accordance with the rules, a free kick stat counted for the team who executes a free kick. Direct or indirect free kicks are all counted as free kicks.
Goal kick	team statistics	Total number of kicks awarded to the team as a result of the ball traveling out of bounds over the goal line of the defending team
Throw ins	team statistics	Total number of thrown in events for a team
Offsides	team statistics	Total number of offside infringements awarded against a team.
Fouls	team statistics	Total number of fouls awarded against a team (including those which draw cards)
Corner Kicks	team statistics	Total number of corner kicks taken by a team.
Shots Saved	team statistics	Total number of goal keeper saves attributed to a team.
Ball Possession	team statistics	Ball possession is the amount of time a team has possession of the ball. It is calculated in percentage, and the total amount of time the match is being played is considered 100%.

Red / Yellow Cards

How do you represent red and yellow cards?

Red and yellow cards are provided with three attributes:

red_cards
yellow_cards
yellow_red_cards

Yellow/red cards (yellow_red_cards) are added when a player receives a second yellow card, resulting in a red card. Red cards (red_cards) are only added when a player receives a red card.

<statistics>
  <totals>
    <competitors>
      <competitor id="sr:competitor:4717" name="Belgium" abbreviation="BEL" qualifier="home">
        <statistics ball_possession="46" cards_given="3" corner_kicks="9" fouls="8" free_kicks="12" goal_kicks="6" injuries="0" offsides="2" penalties_missed="1" red_cards="0" shots_blocked="4" shots_off_target="7" shots_on_target="6" shots_saved="3" shots_total="17" substitutions="4" throw_ins="15" yellow_cards="3" yellow_red_cards="0"/>
        <players>
          <player id="sr:player:70987" name="Casteels, Koen" starter="true">
            <statistics assists="0" corner_kicks="0" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="0" shots_on_target="0" substituted_in="0" substituted_out="0" yellow_cards="0" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:135666" name="Trossard, Leandro" starter="true">
            <statistics assists="0" corner_kicks="0" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="1" shots_off_target="2" shots_on_target="2" substituted_in="0" substituted_out="0" yellow_cards="0" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:329417" name="Castagne, Timothy" starter="true">
            <statistics assists="1" corner_kicks="0" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="0" shots_on_target="0" substituted_in="0" substituted_out="1" yellow_cards="0" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:331737" name="Tielemans, Youri" starter="true">
            <statistics assists="0" corner_kicks="6" goals_scored="0" offsides="1" own_goals="0" penalties_missed="1" red_cards="0" shots_blocked="0" shots_off_target="0" shots_on_target="1" substituted_in="0" substituted_out="1" yellow_cards="0" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:361696" name="Faes, Wout" starter="true">
            <statistics assists="0" corner_kicks="0" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="1" shots_on_target="0" substituted_in="0" substituted_out="0" yellow_cards="1" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:369430" name="Lukebakio, Dodi" starter="false">
            <statistics assists="0" corner_kicks="3" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="0" shots_on_target="0" substituted_in="1" substituted_out="0" yellow_cards="0" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:815708" name="Mangala, Orel" starter="true">
            <statistics assists="0" corner_kicks="0" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="0" shots_on_target="0" substituted_in="0" substituted_out="1" yellow_cards="1" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:936428" name="Bornauw, Sebastiaan" starter="false">
            <statistics assists="0" corner_kicks="0" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="0" shots_on_target="0" substituted_in="0" substituted_out="0" yellow_cards="0" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:973773" name="Openda, Lois" starter="true">
            <statistics assists="0" corner_kicks="0" goals_by_head="1" goals_scored="1" offsides="1" own_goals="0" red_cards="0" shots_blocked="2" shots_off_target="1" shots_on_target="2" substituted_in="0" substituted_out="0" yellow_cards="0" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:1059113" name="Ngonge, Cyril" starter="false">
            <statistics assists="0" corner_kicks="0" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="0" shots_on_target="0" substituted_in="0" substituted_out="0" yellow_cards="0" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:1120733" name="De Wolf, Ortwin" starter="false">
            <statistics assists="0" corner_kicks="0" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="0" shots_on_target="0" substituted_in="0" substituted_out="0" yellow_cards="0" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:1297614" name="Doku, Jeremy" starter="true">
            <statistics assists="0" corner_kicks="0" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="1" shots_on_target="0" substituted_in="0" substituted_out="0" yellow_cards="0" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:1479828" name="Vandevoordt, Maarten" starter="false">
            <statistics assists="0" corner_kicks="0" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="0" shots_on_target="0" substituted_in="0" substituted_out="0" yellow_cards="0" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:1624310" name="De Cuyper, Maxime" starter="false">
            <statistics assists="0" corner_kicks="0" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="1" shots_on_target="0" substituted_in="1" substituted_out="0" yellow_cards="0" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:1624316" name="De Ketelaere, Charles" starter="true">
            <statistics assists="0" corner_kicks="0" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="0" shots_on_target="0" substituted_in="0" substituted_out="1" yellow_cards="1" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:1646402" name="Theate, Arthur" starter="true">
            <statistics assists="0" corner_kicks="0" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="0" shots_on_target="0" substituted_in="0" substituted_out="0" yellow_cards="0" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:1831190" name="Vranckx, Aster" starter="false">
            <statistics assists="0" corner_kicks="0" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="1" shots_on_target="0" substituted_in="1" substituted_out="0" yellow_cards="0" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:1939304" name="Engels, Arne" starter="false">
            <statistics assists="0" corner_kicks="0" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="0" shots_on_target="0" substituted_in="1" substituted_out="0" yellow_cards="0" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:1985243" name="Debast, Zeno" starter="true">
            <statistics assists="0" corner_kicks="0" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="1" shots_off_target="0" shots_on_target="1" substituted_in="0" substituted_out="0" yellow_cards="0" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:1985261" name="Bakayoko, Johan" starter="false">
            <statistics assists="0" corner_kicks="0" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="0" shots_on_target="0" substituted_in="0" substituted_out="0" yellow_cards="0" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:2346779" name="Fofana, Malick" starter="false">
            <statistics assists="0" corner_kicks="0" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="0" shots_on_target="0" substituted_in="0" substituted_out="0" yellow_cards="0" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:2405115" name="Smets, Matte" starter="false">
            <statistics assists="0" corner_kicks="0" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="0" shots_on_target="0" substituted_in="0" substituted_out="0" yellow_cards="0" yellow_red_cards="0"/>
          </player>
        </players>
      </competitor>
      <competitor id="sr:competitor:4481" name="France" abbreviation="FRA" qualifier="away">
        <statistics ball_possession="54" cards_given="6" corner_kicks="4" fouls="12" free_kicks="10" goal_kicks="10" injuries="0" offsides="0" red_cards="0" shots_blocked="3" shots_off_target="4" shots_on_target="5" shots_saved="5" shots_total="12" substitutions="4" throw_ins="7" yellow_cards="5" yellow_red_cards="1"/>
        <players>
          <player id="sr:player:96531" name="Areola, Alphonse" starter="false">
            <statistics assists="0" corner_kicks="0" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="0" shots_on_target="0" substituted_in="0" substituted_out="0" yellow_cards="0" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:96538" name="Digne, Lucas" starter="true">
            <statistics assists="1" corner_kicks="3" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="1" shots_on_target="0" substituted_in="0" substituted_out="0" yellow_cards="1" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:144864" name="Clauss, Jonathan" starter="false">
            <statistics assists="0" corner_kicks="0" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="0" shots_on_target="0" substituted_in="0" substituted_out="0" yellow_cards="0" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:164055" name="Samba, Brice" starter="false">
            <statistics assists="0" corner_kicks="0" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="0" shots_on_target="0" substituted_in="0" substituted_out="0" yellow_cards="0" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:191210" name="Maignan, Mike" starter="true">
            <statistics assists="0" corner_kicks="0" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="0" shots_on_target="0" substituted_in="0" substituted_out="0" yellow_cards="1" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:361350" name="Dembele, Ousmane" starter="true">
            <statistics assists="0" corner_kicks="1" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="1" shots_on_target="0" substituted_in="0" substituted_out="1" yellow_cards="0" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:545970" name="Thuram, Marcus" starter="false">
            <statistics assists="0" corner_kicks="0" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="0" shots_on_target="0" substituted_in="1" substituted_out="0" yellow_cards="0" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:769333" name="Nkunku, Christopher" starter="false">
            <statistics assists="0" corner_kicks="0" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="0" shots_on_target="0" substituted_in="1" substituted_out="0" yellow_cards="0" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:772113" name="Hernandez, Theo" starter="false">
            <statistics assists="0" corner_kicks="0" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="0" shots_on_target="0" substituted_in="0" substituted_out="0" yellow_cards="0" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:936572" name="Konate, Ibrahima" starter="true">
            <statistics assists="0" corner_kicks="0" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="0" shots_on_target="0" substituted_in="0" substituted_out="0" yellow_cards="1" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:940560" name="Kounde, Jules" starter="true">
            <statistics assists="0" corner_kicks="0" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="1" shots_on_target="0" substituted_in="0" substituted_out="0" yellow_cards="0" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:1054707" name="Guendouzi, Matteo" starter="true">
            <statistics assists="0" corner_kicks="0" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="0" shots_on_target="1" substituted_in="0" substituted_out="1" yellow_cards="0" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:1070898" name="Tchouameni, Aurelien" starter="true">
            <statistics assists="0" corner_kicks="0" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="1" shots_off_target="0" shots_on_target="0" substituted_in="0" substituted_out="0" yellow_cards="1" yellow_red_cards="1"/>
          </player>
          <player id="sr:player:1103411" name="Kolo Muani, Randal" starter="true">
            <statistics assists="0" corner_kicks="0" goals_by_head="1" goals_by_penalty="1" goals_scored="2" offsides="0" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="0" shots_on_target="2" substituted_in="0" substituted_out="1" yellow_cards="0" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:1402953" name="Fofana, Wesley" starter="false">
            <statistics assists="0" corner_kicks="0" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="0" shots_on_target="0" substituted_in="0" substituted_out="0" yellow_cards="0" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:1513599" name="Saliba, William" starter="true">
            <statistics assists="0" corner_kicks="0" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="0" shots_on_target="0" substituted_in="0" substituted_out="0" yellow_cards="1" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:1567396" name="Fofana, Youssouf" starter="false">
            <statistics assists="0" corner_kicks="0" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="0" shots_on_target="0" substituted_in="1" substituted_out="0" yellow_cards="0" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:1692931" name="Camavinga, Eduardo" starter="false">
            <statistics assists="0" corner_kicks="0" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="0" shots_on_target="0" substituted_in="1" substituted_out="0" yellow_cards="0" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:1693879" name="Kone, Manu" starter="true">
            <statistics assists="0" corner_kicks="0" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="2" shots_off_target="0" shots_on_target="0" substituted_in="0" substituted_out="0" yellow_cards="0" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:1717779" name="Olise, Michael" starter="false">
            <statistics assists="0" corner_kicks="0" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="0" shots_on_target="0" substituted_in="0" substituted_out="0" yellow_cards="0" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:1948356" name="Barcola, Bradley" starter="true">
            <statistics assists="0" corner_kicks="0" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="1" shots_on_target="2" substituted_in="0" substituted_out="1" yellow_cards="0" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:1983573" name="Bade, Loic" starter="false">
            <statistics assists="0" corner_kicks="0" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="0" shots_on_target="0" substituted_in="0" substituted_out="0" yellow_cards="0" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:2256607" name="Zaire-Emery, Warren" starter="false">
            <statistics assists="0" corner_kicks="0" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="0" shots_on_target="0" substituted_in="0" substituted_out="0" yellow_cards="0" yellow_red_cards="0"/>
          </player>
        </players>
      </competitor>
    </competitors>
  </totals>
</statistics>

<statistics>
  <totals>
    <competitors>
      <competitor id="sr:competitor:6102" name="America de Cali" abbreviation="AME" qualifier="home">
        <statistics ball_possession="48" cards_given="2" corner_kicks="2" fouls="14" free_kicks="15" goal_kicks="1" injuries="1" offsides="1" red_cards="0" shots_blocked="0" shots_off_target="4" shots_on_target="3" shots_saved="3" shots_total="7" substitutions="3" throw_ins="16" yellow_cards="2" yellow_red_cards="0"/>
        <players>
          <player id="sr:player:38172" name="Ramos, Adrian" starter="false">
            <statistics assists="0" corner_kicks="0" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="0" shots_on_target="0" substituted_in="1" substituted_out="0" yellow_cards="0" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:47724" name="Mosquera, Andres" starter="true">
            <statistics assists="0" corner_kicks="0" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="1" shots_on_target="0" substituted_in="0" substituted_out="0" yellow_cards="0" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:123272" name="Bocanegra, Daniel" starter="true">
            <statistics assists="0" corner_kicks="0" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="0" shots_on_target="0" substituted_in="0" substituted_out="0" yellow_cards="1" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:162563" name="Rivera, Harold" starter="true">
            <statistics assists="0" corner_kicks="0" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="0" shots_on_target="0" substituted_in="0" substituted_out="1" yellow_cards="0" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:322529" name="Balanta, Eder" starter="true">
            <statistics assists="0" corner_kicks="0" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="0" shots_on_target="0" substituted_in="0" substituted_out="1" yellow_cards="0" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:333807" name="Leys, Franco" starter="true">
            <statistics assists="0" corner_kicks="0" goals_scored="1" offsides="0" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="1" shots_on_target="1" substituted_in="0" substituted_out="0" yellow_cards="1" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:353296" name="Zapata, Alexis" starter="false">
            <statistics assists="0" corner_kicks="0" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="0" shots_on_target="0" substituted_in="1" substituted_out="0" yellow_cards="0" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:358144" name="Velasco, Edwin" starter="true">
            <statistics assists="0" corner_kicks="0" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="1" shots_on_target="0" substituted_in="0" substituted_out="0" yellow_cards="0" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:589356" name="Castrillon, Nilson" starter="true">
            <statistics assists="0" corner_kicks="0" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="1" shots_on_target="0" substituted_in="0" substituted_out="0" yellow_cards="0" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:1114897" name="Palacios Murillo, Jeisson Andres" starter="false">
            <statistics assists="0" corner_kicks="0" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="0" shots_on_target="0" substituted_in="0" substituted_out="0" yellow_cards="0" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:1239934" name="Holgado, Rodrigo" starter="true">
            <statistics assists="1" corner_kicks="0" goals_scored="0" offsides="1" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="0" shots_on_target="0" substituted_in="0" substituted_out="1" yellow_cards="0" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:1404089" name="Vergara, Duvan" starter="true">
            <statistics assists="0" corner_kicks="2" goals_by_penalty="1" goals_scored="1" offsides="0" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="0" shots_on_target="2" substituted_in="0" substituted_out="0" yellow_cards="0" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:1408013" name="Barrios, Cristian" starter="true">
            <statistics assists="0" corner_kicks="0" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="0" shots_on_target="0" substituted_in="0" substituted_out="0" yellow_cards="0" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:1548027" name="Quinones, Jader" starter="false">
            <statistics assists="0" corner_kicks="0" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="0" shots_on_target="0" substituted_in="1" substituted_out="0" yellow_cards="0" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:1615746" name="Gomez Miranda, Luis Felipe" starter="false">
            <statistics assists="0" corner_kicks="0" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="0" shots_on_target="0" substituted_in="0" substituted_out="0" yellow_cards="0" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:1709205" name="Soto, Jorge" starter="true">
            <statistics assists="0" corner_kicks="0" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="0" shots_on_target="0" substituted_in="0" substituted_out="0" yellow_cards="0" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:1731487" name="Quintero, David" starter="false">
            <statistics assists="0" corner_kicks="0" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="0" shots_on_target="0" substituted_in="0" substituted_out="0" yellow_cards="0" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:2717044" name="Zuleta Garcia, Mateo" starter="false">
            <statistics assists="0" corner_kicks="0" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="0" shots_on_target="0" substituted_in="0" substituted_out="0" yellow_cards="0" yellow_red_cards="0"/>
          </player>
        </players>
      </competitor>
      <competitor id="sr:competitor:6117" name="Millonarios FC" abbreviation="MIL" qualifier="away">
        <statistics ball_possession="52" cards_given="5" corner_kicks="4" fouls="14" free_kicks="15" goal_kicks="12" injuries="0" offsides="1" red_cards="1" shots_blocked="0" shots_off_target="0" shots_on_target="4" shots_saved="1" shots_total="4" substitutions="2" throw_ins="17" yellow_cards="4" yellow_red_cards="0"/>
        <players>
          <player id="sr:player:34090" name="Banguero, Danovis" starter="true">
            <statistics assists="0" corner_kicks="0" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="0" shots_on_target="0" substituted_in="0" substituted_out="0" yellow_cards="1" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:180063" name="Giraldo, Daniel" starter="false">
            <statistics assists="0" corner_kicks="0" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="0" shots_on_target="0" substituted_in="0" substituted_out="0" yellow_cards="0" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:248067" name="Silva, David" starter="true">
            <statistics assists="0" corner_kicks="0" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="0" shots_on_target="0" substituted_in="0" substituted_out="1" yellow_cards="0" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:248983" name="Novoa, Diego" starter="true">
            <statistics assists="0" corner_kicks="0" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="0" shots_on_target="0" substituted_in="0" substituted_out="0" yellow_cards="0" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:355842" name="Arias, Jorge" starter="true">
            <statistics assists="0" corner_kicks="0" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="0" shots_on_target="0" substituted_in="0" substituted_out="0" yellow_cards="1" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:590354" name="Vega, Stiven" starter="true">
            <statistics assists="0" corner_kicks="0" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="0" shots_on_target="0" substituted_in="0" substituted_out="0" yellow_cards="0" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:774445" name="Castro, Leonardo" starter="true">
            <statistics assists="0" corner_kicks="0" goals_scored="1" offsides="0" own_goals="0" red_cards="1" shots_blocked="0" shots_off_target="0" shots_on_target="3" substituted_in="0" substituted_out="0" yellow_cards="0" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:841053" name="Arboleda, Ivan" starter="false">
            <statistics assists="0" corner_kicks="0" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="0" shots_on_target="0" substituted_in="0" substituted_out="0" yellow_cards="0" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:1403997" name="Mantilla, Daniel" starter="true">
            <statistics assists="0" corner_kicks="0" goals_scored="0" offsides="1" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="0" shots_on_target="0" substituted_in="0" substituted_out="1" yellow_cards="0" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:1695113" name="Cordoba Mosquera, Jhon Emerson" starter="true">
            <statistics assists="0" corner_kicks="0" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="0" shots_on_target="0" substituted_in="0" substituted_out="0" yellow_cards="0" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:1704443" name="Charrupi Mina, Felix Eduardo" starter="false">
            <statistics assists="0" corner_kicks="0" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="0" shots_on_target="0" substituted_in="0" substituted_out="0" yellow_cards="0" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:1738005" name="Llinas, Andres" starter="true">
            <statistics assists="0" corner_kicks="0" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="0" shots_on_target="0" substituted_in="0" substituted_out="0" yellow_cards="1" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:2114168" name="Ruiz Rivera, Daniel" starter="false">
            <statistics assists="0" corner_kicks="0" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="0" shots_on_target="0" substituted_in="1" substituted_out="0" yellow_cards="0" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:2681047" name="Villarreal, Neisser" starter="false">
            <statistics assists="0" corner_kicks="0" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="0" shots_on_target="0" substituted_in="1" substituted_out="0" yellow_cards="0" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:2822953" name="Ramirez, Juan Daniel" starter="true">
            <statistics assists="0" corner_kicks="4" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="0" shots_on_target="1" substituted_in="0" substituted_out="0" yellow_cards="0" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:2868429" name="Sarabia Barrios, Carlos Eduardo" starter="true">
            <statistics assists="0" corner_kicks="0" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="0" shots_on_target="0" substituted_in="0" substituted_out="0" yellow_cards="1" yellow_red_cards="0"/>
          </player>
          <player id="sr:player:2876001" name="Cortez, Darwin" starter="false">
            <statistics assists="0" corner_kicks="0" goals_scored="0" offsides="0" own_goals="0" red_cards="0" shots_blocked="0" shots_off_target="0" shots_on_target="0" substituted_in="0" substituted_out="0" yellow_cards="0" yellow_red_cards="0"/>
          </player>
        </players>
      </competitor>
    </competitors>
  </totals>
</statistics>

What are the possible values for `event` – `card_description` in the Timeline feeds?

pre_match
half_time
post_match
player_on_bench
first_half
second_half
during_penalty_shootout

Leaders

What are the possible values for `list` – `type` in the Season Leaders endpoint?

points
goals
assists
red_cards
yellow_cards
yellow_red_cards
own_goals
shots_on_target
shots_off_target
goals_by_head
goals_by_penalty
clearances
interceptions
chances_created
crosses_successful
passes_successful
long_passes_successful
tackles_successful
clean_sheets
penalties_saved
dribbles_completed
loss_of_possession
minutes_played

Note: Not all values may be available for each season, based on the coverage available for that season.

Weather

What are the possible weather conditions?

indoor
good
medium
bad
extreme

What are the possible pitch values?

good
medium
bad

Simulations

Are simulations available for Soccer v4?

Simulations for Soccer v4 are not currently available.

Replay Matches

How are replay cup matches handled?

Within the Summary, Timeline, or Lineups endpoints you can locate the round data for a given match. In that round data you can find the number of matches in the cup round (cup_round_number_of_sport_events) and the number of the given match in the cup round (cup_round_sport_event_number).

The values for cup_round_sport_event_number are detailed below:

1 = Replay
2 = 1st Replay
3 = 2nd Replay

TV Coverage

Which regions are covered with TV channel data?

We offer network TV data for the United States.

This will be available for:

MLS
World Cup
EPL
UEFA Champions League
Bundesliga
Liga MX
Gold Cup.

Sport Events Updated

What prompts a match to appear in Sport Events Updated?

Changes to score, match status, or schedule in last 24 hours cause a match to display in this endpoint.

Commentary

Why don’t I see commentary in Sport Event Timeline when the coverage has `commentary="true"` under `sport_event_property`?

Commentary is only available for a fixed amount of time (14 days typically). The attribute, which denotes that commentary is or was available, remains even after the commentary is removed.

When are fun facts added to the Sport Event Fun Facts endpoint?

Fun facts appear in Sport Event Fun Facts 7 days before a match and are available for a fixed amount of time (14 days typically).

Minutes Played

How is the `minutes_played` statistic calculated?

Minutes played is calculated based on 90 minutes in the match. We do not include stoppage_time.

Categories