Syntax

https://api.sportradar.com/mlb/{access_level}/stream/{language_code}/linescore/subscribe

Parameters

Parameter	Description
`access_level`	Defines the access level of your API key `production`, `trial`
`language_code`	2-letter code for supported languages `en` (English)

Optional Query String Parameters

By default, a Push feed will provide all data available for all in progress games. If needed, you can filter the data returned by including query strings.

Each query string parameter can be added with a preceding ampersand (&).

Parameter	Description
`match`	Game id Example: `match=sd:match:7779b2fe-70ad-4823-8c6d-9e2453576e2a`
`status`	Game status `inprogress`, `created` Example: `status=inprogress`

Code Samples

require 'uri'
require 'net/http'
require 'openssl'

url = URI("https://api.sportradar.com/mlb/trial/stream/en/linescore/subscribe")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE

request = Net::HTTP::Get.new(url)
request["x-api-key"] = "{your_api_key}"  # Replace with your actual key

response = http.request(request)
puts response.read_body

import requests
import json

headers = {
    'x-api-key': 'your_api_key'  # Replace with your actual key
}

r = requests.get(
    "https://api.sportradar.com/mlb/trial/stream/en/linescore/subscribe",
    headers=headers,
    allow_redirects=False
)

redirect_url = r.headers['Location']
r = requests.get(redirect_url, stream=True, headers=headers)

for line in r.iter_lines():
    # filter out keep-alive new lines
    if line:
        decoded_line = line.decode('utf-8')
        print(json.loads(decoded_line))

curl -L -X GET 'https://api.sportradar.com/mlb/trial/stream/en/linescore/subscribe' \
  -H 'x-api-key: {your_api_key}'

Samples with Query String Params

require 'uri'
require 'net/http'
require 'openssl'

url = URI("https://api.sportradar.com/mlb/trial/stream/en/linescore/subscribe?&status=inprogress&match=sd:match:673b459c-7506-4c11-9273-1b9502537f1d")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE

request = Net::HTTP::Get.new(url)
request["x-api-key"] = "{your_api_key}"  # Replace with your actual key

response = http.request(request)
puts response.read_body

import requests
import json

headers = {
    'x-api-key': 'your_api_key'  # Replace with your actual key
}

r = requests.get("https://api.sportradar.com/mlb/trial/stream/en/linescore/subscribe",
    params = {'status': 'inprogress', 'match': 'sd:match:673b459c-7506-4c11-9273-1b9502537f1d'},
    allow_redirects=False)

redirect_url = r.headers['Location']
r = requests.get(redirect_url, stream=True)

for line in r.iter_lines():
    # filter out keep-alive new lines
    if line:
        decoded_line = line.decode('utf-8')
        print(json.loads(decoded_line))

curl -L -X GET 'api.sportradar.com/mlb/trial/stream/en/linescore/subscribe?&status=inprogress&match=sd:match:673b459c-7506-4c11-9273-1b9502537f1d'
  -H 'x-api-key: {your_api_key}'

Response Samples

The above commands return json like this.

Simulations

Check out our Simulations to replay actual games at any time, on your own schedule. Push simulations are available as well.

Data Points

Metadata

Attribute	Parent Element	Type	Description
`league`	`metadata`	String	Alias of a league ex. `MLB`
`locale`	`metadata`	String	Language code ex. `en` (English)
`match`	`metadata`	GUID	Unique ID of a game ex. `sd:match:30ad883f-aeaf-4e6b-9fd9-a1cc0b6c4679`
`operation`	`metadata`	String	Operation of an update `create`, `update`, `delete`
`status`	`metadata`	String	The status of a game `scheduled`, `inprogress`, `complete`, `closed`, `wdelay`, `fdelay`, `odelay`, `canceled`, `unnecessary`, `if-necessary`, `postponed`, `suspended`, `maintenance`
`version`	`metadata`	String	Version of the API ex. `v6.5`

Boxscore

Attribute	Parent Element	Type	Description
`abbr`	`away`	String	Abbreviation of the away team ex. `MIN` (Minnesota)
`errors`	`away`	Integer	Number of errors for the away team
`hits`	`away`	Integer	Number of hits for the away team
`id`	`away`	GUID	Unique ID of the away team ex. `29dd9a87-5bcc-4774-80c3-7f50d985068b`
`id`	`away`-`probable_pitcher`	GUID	Unique ID of the away team's probable pitcher ex. `515af486-d938-4cb6-90e4-943323a5737c`
`market`	`away`	String	Market name of the away team ex. `Colorado`
`name`	`away`	String	Team name of the away team ex. `Rockies`
`runs`	`away`	Integer	Number of runs for the away team in the game
`abbr`	`home`	String	Abbreviation of the home team ex. `CLE` (Cleveland)
`errors`	`home`	Integer	Number of errors for the home team
`hits`	`home`	Integer	Number of hits for the home team
`id`	`home`	GUID	Unique ID of the home team ex. `29dd9a87-5bcc-4774-80c3-7f50d985068b`
`id`	`home`-`probable_pitcher`	GUID	Unique ID of the home team's probable pitcher ex. `515af486-d938-4cb6-90e4-943323a5737c`
`market`	`home`	String	Market name of the home team ex. `Cleveland`
`name`	`home`	String	Team name of the home team ex. `Guardians`
`runs`	`home`	Integer	Number of runs for the home team in the game
`away`	`linescore`	Integer	Number of runs for the away team in the game
`home`	`linescore`	Integer	Number of runs for the home team in the game
`inning`	`linescore`	Integer	Number of the current inning
`abbr`	`team`	String	Abbreviation of a team ex. `TB` (Tampa Bay)
`id`	`team`	GUID	Unique ID of a team ex. `bdc11650-6f74-49c4-875e-778aeb7632d9`
`market`	`team`	String	Market name of a team ex. `Tampa Bay`
`name`	`team`	String	Team name ex. `Rays`

Game

Attribute	Parent Element	Type	Description
`away_team`	`game`	GUID	Unique ID of the away team ex. `29dd9a87-5bcc-4774-80c3-7f50d985068b`
`coverage`	`game`	String	Coverage level of a game `full`, `boxscore`
`double_header`	`game`	Boolean	Signifies whether a game is part of a double header
`day_night`	`game`	String	Signifies a day or night game `D`, `N`
`entry_mode`	`game`	String	Signifies the type of data entry `STOMP`, `LDE`
`gameday_type`	`game`	String	Coverage level of a game defined as Premium, Enhanced, or Regular `P` - Premium Pitch tracking, player tracking, and full Statcast product experience `E` - Enhanced Pitch tracking but not full Statcast product experience `Y` - Regular Pitch-by-Pitch resulting but no Statcast product experience ex. `gameday_type="E"`
`home_team`	`game`	GUID	Unique ID of the home team ex. `ef64da7f-cfaf-4300-87b0-9313386b977c`
`id`	`game`	GUID	Unique ID of the game ex. `1b554f5e-d8b7-4268-95da-2f4191015c84`
`game_number`	`game`	Integer	Number of the game
`reference`	`game`	String	Unique MLBAM ID of a game
`scheduled`	`game`	dateTime	Scheduled date and time of a game ex. `2022-09-25T20:10:00+00:00`
`split_squad`	`game`	Boolean	Signifies a Spring Training split squad game
`status`	`game`	String	The status of a game. See our FAQ for all statuses and their definitions. `scheduled`, `inprogress`, `complete`, `closed`, `wdelay`, `fdelay`, `odelay`, `canceled`, `unnecessary`, `if-necessary`, `postponed`, `suspended`, `maintenance`

Play-By-Play - Count

Attribute	Parent Element	Type	Description
`balls`	`boxscore`	Integer	Number of balls in an at bat
`outs`	`boxscore`	Integer	Number of outs in an at bat
`inning_half`	`boxscore`	String	Inning half of a player entering the game `T`, `B`
`inning`	`boxscore`	Integer	Inning of a player entering the game
`pitch_count`	`boxscore`	Integer	Number of pitches in an at bat
`strikes`	`boxscore`	Integer	Number of strikes in an at bat

Current Baserunners

Attribute	Parent Element	Type	Description
`base`	`runners`	Integer	Runner's base at the end of a play
`first_name`	`runners`	String	First name of the current runner ex. `Markus`
`full_name`	`runners`	String	Full name of the current runner ex. `Mookie Betts`
`suffix`	`runners`	String	Name suffix of the current runner ex. `Jr.`
`jersey_number`	`runners`	Integer	Number of the current runner's jersey
`last_name`	`runners`	String	Last name of the current runner ex. `Betts`
`out`	`outcome`-`runner`	Boolean	Signifies the runner was out on a play
`preferred_name`	`runners`	String	Preferred name of the current runner ex. `Mookie`

Current Hitter

Attribute	Parent Element	Type	Description
`first_name`	`hitter`	String	First name of the current hitter ex. `Markus`
`full_name`	`hitter`	String	Full name of the current hitter ex. `Mookie Betts`
`suffix`	`hitter`	String	Name suffix of the current hitter ex. `Jr.`
`hitter_hand`	`hitter`	Boolean	Handedness of a hittter
`jersey_number`	`hitter`	Integer	Number of the current hitter's jersey
`last_name`	`hitter`	String	Last name of the current hitter ex. `Betts`
`lineup_order`	`hitter`	Integer	Lineup order number of the current hitter
`lineup_position`	`hitter`	String	Lineup position of the current hitter
`preferred_name`	`hitter`	String	Preferred name of the current hitter ex. `Mookie`

Current Pitcher

Attribute	Parent Element	Type	Description
`first_name`	`pitcher`	String	First name of the current pitcher ex. `Clayton`
`full_name`	`pitcher`	String	Full name of the current pitcher ex. `Clayton Kershaw`
`suffix`	`pitcher`	String	Name suffix of the current pitcher ex. `Jr.`
`jersey_number`	`pitcher`	Integer	Number of the current pitcher's jersey
`last_name`	`pitcher`	String	Last name of the current pitcher ex. `Kershaw`
`pitch_count`	`pitcher`	Integer	Pitch count of the current pitcher
`pitch_hand`	`pitcher`	String	Pitching hand of the current pitcher
`preferred_name`	`pitcher`	String	Preferred name of the current pitcher ex. `Clayton`