Soccer APIs – Friendly Competition Flag

We've added an identifier for all friendly competitions in each of our Soccer APIs.

Use the new is_friendly boolean value in the Season Info endpoint to determine whether a competition is a friendly (exhibition).

⭐ Benefit

Identify and filter friendly (exhibition) competitions across both Soccer APIs — so you can flag exhibition matches in your UI, separate them from competitive fixtures, or exclude them from standings and stats displays.

📋 Recommended Actions

Read the is_friendly boolean from competition_properties in the Season Info endpoint to determine whether a competition is a friendly (exhibition).
Use it to label exhibition matches, separate them from competitive fixtures, or exclude them from standings, stats, and predictive displays where friendlies would skew results.
The attribute is always present: friendly competitions return is_friendly="true" and all others return is_friendly="false", so you can read it directly without null-checking for an absent value.

🔢 Products

Sport	Product	Version(s)
Soccer	Soccer API	v4
Soccer	Soccer Extended API	v4

🔁 Endpoints Affected

Season Info

☑️ Sample Request:

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

⚙️ Return Samples

<!-- within the season_info response -->
    <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="post" team_squads="false" is_friendly="true"/>
        <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" goal_scorers_live="false" scores="post" assists="false"/>
    </coverage>
    <!-- ...additional coverage detail omitted... -->

{
    "generated_at": "2026-08-23T10:51:25+00:00",
    "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": "post",
            "team_squads": false,
            "is_friendly": true
        },
        "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,
            "goal_scorers_live": false,
            "scores": "post",
            "assists": false
        }
    }
    // ...additional fields omitted...
}