Release Log
Coverage MatrixDocumentationChange LogLog InContact Us
Release Log

Global Baseball & Global Football APIs

Neutral Ground Signifier

Release DateEndpointsBenefit
08/19/2024All Summary Endpoints

All Sport Event Endpoints

Sport Event Timeline
We've added a neutral ground signifier to all games in the API.

All sport_event, summary, and timeline endpoints will now include a sport_event_conditions element with ground neutral="true" in cases of a neutral ground matchup.

This matches the current behavior of other General Sport APIs.
<sport_event id="sr:sport_event:46683279" start_time="2024-07-08T16:35:00+00:00" start_time_confirmed="true">
	<sport_event_context>
		<sport id="sr:sport:3" name="Baseball"/>
		<category id="sr:category:16" name="USA" country_code="USA"/>
		<competition id="sr:competition:109" name="MLB" gender="men"/>
		<season id="sr:season:112588" name="MLB 2024" start_date="2024-03-20" end_date="2024-11-03" year="2024" competition_id="sr:competition:109"/>
		<stage order="1" type="league" phase="regular season" start_date="2024-03-20" end_date="2024-10-01" year="2024"/>
		<round number="1"/>
		<groups>
			<group id="sr:league:80909" name="MLB 2024"/>
			<group id="sr:league:80919" name="MLB 2024, National League" group_name="National League"/>
			<group id="sr:league:80921" name="MLB 2024, National League Central" group_name="National League Central"/>
			<group id="sr:league:80923" name="MLB 2024, National League East" group_name="National League East"/>
		</groups>
	</sport_event_context>
	<coverage type="sport_event">
		<sport_event_properties basic_play_by_play="true" scores="live"/>
	</coverage>
	<competitors>
		<competitor id="sr:competitor:3637" name="Pittsburgh Pirates" country="USA" country_code="USA" abbreviation="PIT" qualifier="home" gender="male"/>
		<competitor id="sr:competitor:3629" name="New York Mets" country="USA" country_code="USA" abbreviation="NYM" qualifier="away" gender="male"/>
	</competitors>
	<venue id="sr:venue:8085" name="PNC Park" capacity="38753" city_name="Pittsburgh" country_name="USA" map_coordinates="40.4471507,-80.0064087" country_code="USA" timezone="America/New_York"/>
	<sport_event_conditions>
		<ground neutral="false"/>
	</sport_event_conditions>
</sport_event>
<sport_event_status status="closed" match_status="ended" home_score="8" away_score="2" winner_id="sr:competitor:3637">
	<period_scores>
		<period_score home_score="0" away_score="0" type="regular_period" number="1"/>
		<period_score home_score="0" away_score="0" type="regular_period" number="2"/>
		<period_score home_score="0" away_score="0" type="regular_period" number="3"/>
		<period_score home_score="2" away_score="0" type="regular_period" number="4"/>
		<period_score home_score="0" away_score="0" type="regular_period" number="5"/>
		<period_score home_score="5" away_score="2" type="regular_period" number="6"/>
		<period_score home_score="0" away_score="0" type="regular_period" number="7"/>
		<period_score home_score="1" away_score="0" type="regular_period" number="8"/>
		<period_score home_score="0" away_score="0" type="regular_period" number="9"/>
	</period_scores>
</sport_event_status>undefined</sport_event_summary>
{
  "generated_at": "2024-08-19T13:10:56+00:00",
  "sport_event": {
    "id": "sr:sport_event:46683279",
    "start_time": "2024-07-08T16:35:00+00:00",
    "start_time_confirmed": true,
    "sport_event_context": {
      "sport": {
        "id": "sr:sport:3",
        "name": "Baseball"
      },
      "category": {
        "id": "sr:category:16",
        "name": "USA",
        "country_code": "USA"
      },
      "competition": {
        "id": "sr:competition:109",
        "name": "MLB",
        "gender": "men"
      },
      "season": {
        "id": "sr:season:112588",
        "name": "MLB 2024",
        "start_date": "2024-03-20",
        "end_date": "2024-11-03",
        "year": "2024",
        "competition_id": "sr:competition:109"
      },
      "stage": {
        "order": 1,
        "type": "league",
        "phase": "regular season",
        "start_date": "2024-03-20",
        "end_date": "2024-10-01",
        "year": "2024"
      },
      "round": {
        "number": 1
      },
      "groups": [
        {
          "id": "sr:league:80909",
          "name": "MLB 2024"
        },
        {
          "id": "sr:league:80919",
          "name": "MLB 2024, National League",
          "group_name": "National League"
        },
        {
          "id": "sr:league:80921",
          "name": "MLB 2024, National League Central",
          "group_name": "National League Central"
        },
        {
          "id": "sr:league:80923",
          "name": "MLB 2024, National League East",
          "group_name": "National League East"
        }
      ]
    },
    "coverage": {
      "type": "sport_event",
      "sport_event_properties": {
        "basic_play_by_play": true,
        "scores": "live"
      }
    },
    "competitors": [
      {
        "id": "sr:competitor:3637",
        "name": "Pittsburgh Pirates",
        "country": "USA",
        "country_code": "USA",
        "abbreviation": "PIT",
        "qualifier": "home",
        "gender": "male"
      },
      {
        "id": "sr:competitor:3629",
        "name": "New York Mets",
        "country": "USA",
        "country_code": "USA",
        "abbreviation": "NYM",
        "qualifier": "away",
        "gender": "male"
      }
    ],
    "venue": {
      "id": "sr:venue:8085",
      "name": "PNC Park",
      "capacity": 38753,
      "city_name": "Pittsburgh",
      "country_name": "USA",
      "map_coordinates": "40.4471507,-80.0064087",
      "country_code": "USA",
      "timezone": "America/New_York"
    },
    "sport_event_conditions": {
      "ground": {
        "neutral": false
      }
    }
  },
  "sport_event_status": {
    "status": "closed",
    "match_status": "ended",
    "home_score": 8,
    "away_score": 2,
    "winner_id": "sr:competitor:3637",
    "period_scores": [
      {
        "home_score": 0,
        "away_score": 0,
        "type": "regular_period",
        "number": 1
      },
      {
        "home_score": 0,
        "away_score": 0,
        "type": "regular_period",
        "number": 2
      },
      {
        "home_score": 0,
        "away_score": 0,
        "type": "regular_period",
        "number": 3
      },
      {
        "home_score": 2,
        "away_score": 0,
        "type": "regular_period",
        "number": 4
      },
      {
        "home_score": 0,
        "away_score": 0,
        "type": "regular_period",
        "number": 5
      },
      {
        "home_score": 5,
        "away_score": 2,
        "type": "regular_period",
        "number": 6
      },
      {
        "home_score": 0,
        "away_score": 0,
        "type": "regular_period",
        "number": 7
      },
      {
        "home_score": 1,
        "away_score": 0,
        "type": "regular_period",
        "number": 8
      },
      {
        "home_score": 0,
        "away_score": 0,
        "type": "regular_period",
        "number": 9
      }
    ]
  }
}

Update applies to: Global Baseball v2, Global American Football v2