GuidesRelease Log
Coverage MatrixDocumentationChange LogLog InContact Us
Release Log

Soccer APIs – Phase Type Attribute in Season Standings & Season Info

We've added a phase_type attribute to each stage in the Season Info and Season Standings endpoints of our Soccer APIs.

phase_type is a more specific, canonical version of the existing phase attribute. It disambiguates stages that would otherwise collapse to the same phase value — most commonly in competitions with Apertura/Clausura formats (common in Latin American football) and multi-stage domestic competitions, where several stages all carry phase="regular season" and are indistinguishable without extra context.

Together with type, phase_type forms a stable, unique key (type, phase_type) for each stage within a season. For example:

  • Uruguay Primera Division 2026 — (league, apertura), (league, regular_season), (league, group_stage), (league, clausura)
  • Brazil Serie C 2024 — (league, regular_season) and (league, group_stage) are now distinct, where previously both stages were tagged phase="regular season"
📌

This is an additive change. The existing phase attribute is unchanged for backward compatibility.


⭐ Benefit

Correctly label multi-stage league competitions — Apertura, Clausura, Group Stage, and others — in your standings displays, and reliably match stages between Season Standings and Season Info without relying on fragile fallbacks like dates or stage order.


📋 Recommended Actions

  • Read phase_type from each stage object in Season Standings responses, alongside the existing type and phase attributes.
  • Use (type, phase_type) as a stable, unique key when matching Season Standings stages to Season Info stages, or when distinguishing multiple stages within a single season.
  • Display phase_type values (e.g. apertura, clausura, group_stage) to label stages correctly in multi-stage league competitions.
  • The existing phase attribute is unchanged — if your integration keys off phase today, it continues to work.

🔢 Products

SportProductVersion(s)
SoccerSoccer APIv4
SoccerSoccer Extended APIv4

🔁 Endpoints Affected (Soccer and Soccer Extended)


☑️ Sample Request:

Season Standings — Uruguay Primera 2026 — Soccer API

curl --request GET \
     --url https://api.sportradar.com/soccer/trial/v4/en/seasons/sr:season:139306/standings.json \
     --header 'accept: application/json' \
     --header 'x-api-key: YOUR_API_KEY'

⚙️ Return Samples

<group id="sr:league:104776" name="Primera Division 2026, Apertura" live="false" parent_group_id="sr:league:104780" group_name="Apertura">
    <stage order="1" type="league" phase="regular season" start_date="2026-02-06" end_date="2026-05-11" year="2026" phase_type="apertura"/>
    <standings>
        <standing rank="1" played="7" win="6" loss="1" draw="0" goals_for="13" goals_against="6" goals_diff="7" points="18" change="0" points_per_game="2.57">
            <competitor id="sr:competitor:3234" name="Deportivo Maldonado" country="Uruguay" country_code="URY" abbreviation="MAL" gender="male" form="WWWDW"/>
        </standing>
        <standing rank="2" played="8" win="4" loss="1" draw="3" goals_for="13" goals_against="8" goals_diff="5" points="15" current_outcome="Playoffs" change="0" points_per_game="1.88">
            <competitor id="sr:competitor:25010" name="Racing Club Montevideo" country="Uruguay" country_code="URY" abbreviation="RCM" gender="male" form="WWLWW"/>
        </standing>
        ... (14 additional teams)
    </standings>
</group>
<group id="sr:league:104778" name="Primera Division 2026, Clausura" live="false" group_name="Clausura">
    <stage order="4" type="league" phase="regular season" start_date="2026-08-07" end_date="2026-11-09" year="2026" phase_type="clausura"/>
    <standings>
        <standing rank="1" played="7" win="6" loss="0" draw="1" goals_for="12" goals_against="2" goals_diff="10" points="19" current_outcome="Playoffs" change="1" points_per_game="2.71">
            <competitor id="sr:competitor:6879" name="Liverpool Montevideo" country="Uruguay" country_code="URY" abbreviation="LIV" gender="male" form="WDWWW"/>
        </standing>
        ... (15 additional teams)
    </standings>
</group>
<group id="sr:league:104782" name="Primera Division 2026, Torneo Intermedio, Group A" live="false" group_name="Intermedio A">
    <stage order="2" type="league" phase="regular season" start_date="2026-05-16" end_date="2026-08-03" year="2026" phase_type="group_stage"/>
    <standings>
        <standing rank="1" played="4" win="3" loss="1" draw="0" goals_for="8" goals_against="2" goals_diff="6" points="9" current_outcome="Finals" change="1" points_per_game="2.25">
            <competitor id="sr:competitor:3227" name="CA Penarol Montevideo" country="Uruguay" country_code="URY" abbreviation="PEN" gender="male" form="LWWDD"/>
        </standing>
        ... (7 additional teams)
    </standings>
</group>
{
    "generated_at": "2026-11-02T15:16:33+00:00",
    "season": {
        "id": "sr:season:116539",
        "name": "Brasileiro Serie C 2024",
        "year": "2024",
        "competition": { "id": "sr:competition:1281", "name": "Brasileiro Serie C", "gender": "men" }
    },
    "stages": [
        {
            "order": 1,
            "type": "league",
            "phase": "regular season",
            "start_date": "2024-04-20",
            "end_date": "2024-10-21",
            "year": "2024",
            "phase_type": "regular_season"
        },
        {
            "order": 1,
            "type": "league",
            "phase": "regular season",
            "start_date": "2024-08-30",
            "end_date": "2024-10-07",
            "year": "2024",
            "phase_type": "group_stage"
        },
        {
            "order": 2,
            "type": "cup",
            "phase": "playoffs",
            "start_date": "2024-10-11",
            "end_date": "2024-10-19",
            "year": "2024",
            "phase_type": "playoffs"
        }
    ]
    ...
}