Soccer APIs - Formation Coverage Property

We've added a new boolean property to our Soccer APIs to signify when a match has team formation info available. Access this data point at the season (Season Info) or sport event (Summary, Timeline, etc) level.

Note that there will be some competitions in which lineups (lineups="true) are available but not formations (formations="false").

sport_event_properties.formations - Signifies team formations are available for a sport event when true

☑️ Sample Request:

Season Summaries (v4) - https://api.sportradar.com/soccer/trial/v4/en/seasons/{season_id}/summaries?api_key=?api_key=[API_KEY]

🔢 Versions

🔁 Endpoints Affected

Competitor Schedules, Competitor Summaries, Competitor vs Competitor, Daily Schedules, Daily Summaries, League Timeline, Live Schedules, Live Summaries, Player Schedules, Player Summaries, Season Info, Season Lineups, Season Probabilities, Season Schedule, Season Summaries, Sport Event Lineups, Sport Event Summary, Sport Event Timeline, Live Probabilities, Sport Event Probabilities, Timeline Probabilities

⚙️ Return Sample

<summary>
  <sport_event id="sr:sport_event:51092345" start_time="2024-08-09T19:00:00+00:00" start_time_confirmed="true">
    <sport_event_context>
      <sport id="sr:sport:1" name="Soccer"/>
      <category id="sr:category:1" name="England" country_code="ENG"/>
      <competition id="sr:competition:24" name="League One" gender="men"/>
      <season id="sr:season:118703" name="League One" start_date="2024-08-09" end_date="2025-05-03" year="24/25" competition_id="sr:competition:24"/>
      <stage order="1" type="league" phase="regular season" start_date="2024-08-09" end_date="2025-05-03" year="24/25"/>
      <round number="1"/>
      <groups>
        <group id="sr:league:84333" name="League One 24/25"/>
      </groups>
    </sport_event_context>
    <coverage type="sport_event">
      <sport_event_properties lineups="true" formations="false" venue="false" extended_player_stats="false" extended_team_stats="false" lineups_availability="post" ballspotting="false" commentary="false" fun_facts="true" goal_scorers="true" goal_scorers_live="false" scores="live" game_clock="true" deeper_play_by_play="false" deeper_player_stats="false" deeper_team_stats="false" basic_play_by_play="true" basic_player_stats="true" basic_team_stats="true"/>
    </coverage>

"summaries": [
  {
    "sport_event": {
      "id": "sr:sport_event:51092345",
      "start_time": "2024-08-09T19:00:00+00:00",
      "start_time_confirmed": true,
      "sport_event_context": {
        "sport": {
          "id": "sr:sport:1",
          "name": "Soccer"
        },
        "category": {
          "id": "sr:category:1",
          "name": "England",
          "country_code": "ENG"
        },
        "competition": {
          "id": "sr:competition:24",
          "name": "League One",
          "gender": "men"
        },
        "season": {
          "id": "sr:season:118703",
          "name": "League One",
          "start_date": "2024-08-09",
          "end_date": "2025-05-03",
          "year": "24/25",
          "competition_id": "sr:competition:24"
        },
        "stage": {
          "order": 1,
          "type": "league",
          "phase": "regular season",
          "start_date": "2024-08-09",
          "end_date": "2025-05-03",
          "year": "24/25"
        },
        "round": {
          "number": 1
        },
        "groups": [
          {
            "id": "sr:league:84333",
            "name": "League One 24/25"
          }
        ]
      },
      "coverage": {
        "type": "sport_event",
        "sport_event_properties": {
          "lineups": true,
          "formations": false,
          "venue": false,
          "extended_player_stats": false,
          "extended_team_stats": false,
          "lineups_availability": "post",
          "ballspotting": false,
          "commentary": false,
          "fun_facts": true,
          "goal_scorers": true,
          "goal_scorers_live": false,
          "scores": "live",
          "game_clock": true,
          "deeper_play_by_play": false,
          "deeper_player_stats": false,
          "deeper_team_stats": false,
          "basic_play_by_play": true,
          "basic_player_stats": true,
          "basic_team_stats": true
        }
      },