---
agentTools:
  siteIndex: https://developer.sportradar.com/llms.txt
  projectIndex: https://developer.sportradar.com/sportradar-updates/llms.txt
---

# 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 <Anchor target="_blank" href="https://developer.sportradar.com/soccer/reference/soccer-season-info">Season Info</Anchor> endpoint to determine whether a competition is a friendly (exhibition).

<br />

⭐ **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.

<br />

📋 **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.

<br />

🔢 **Products**

| Sport  | Product                                                                                                                                | Version(s) |
| ------ | -------------------------------------------------------------------------------------------------------------------------------------- | ---------- |
| Soccer | <Anchor target="_blank" href="https://developer.sportradar.com/soccer/reference/soccer-overview">Soccer API</Anchor>                   | v4         |
| Soccer | <Anchor target="_blank" href="https://developer.sportradar.com/soccer/reference/soccer-extended-overview">Soccer Extended API</Anchor> | v4         |

<br />

🔁 **Endpoints Affected**

* Season Info

<br />

☑️ **Sample Request:**

```curl Season Info Endpoint
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'
```

<br />

⚙️ **Return Samples**

```xml
<!-- 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... -->
```
```json
{
    "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...
}
```