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 taggedphase="regular season"
This is an additive change. The existing
phaseattribute 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_typefrom eachstageobject in Season Standings responses, alongside the existingtypeandphaseattributes. - 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_typevalues (e.g.apertura,clausura,group_stage) to label stages correctly in multi-stage league competitions. - The existing
phaseattribute is unchanged — if your integration keys offphasetoday, it continues to work.
🔢 Products
| Sport | Product | Version(s) |
|---|---|---|
| Soccer | Soccer API | v4 |
| Soccer | Soccer Extended API | v4 |
🔁 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"
}
]
...
}