Push Scorecard

Syntax

https://api.sportradar.com/golf/{access_level}/stream/{golf_tour}/scorecards/subscribe?&locale=en

Parameters

Parameter	Description
`access_level`	Defines the access level of your API key `production`, `trial`
`golf_tour`	Golf tour `champ` (PGA Tour Champions), `euro` (PGA European Tour), `liv` (LIV Golf), `lpga` (LPGA), `oly` (Olympics), `pga` (PGA Tour), `pgad` (Korn Ferry Tour)

🔐
Authorization
Place your API key in the header for each request (x-api-key)

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
`tournament`	Tournament id Example: `sd:tournament:9db12181-b55d-4e4f-8c18-936f4c7c7e2d`
`tournament_type`	Tournament type Example: `tournament_type=stroke`
`scoring_system`	Scoring system Example: `scoring_system=match`
`round`	Round sequence number Example: `round=2`
`player`	Player id Example: `sd:player:da226913-b804-48de-adbf-96e956eb75ac`
`locale`	Language returned expressed as a 2-letter code `zh` (Chinese - simplified), `zht` (Chinese - traditional), `da` (Danish), `nl` (Dutch), `en` (English), `fi` (Finnish), `fr` (French), `de` (German), `it` (Italian), `ja` (Japanese), `ko` (Korean), `no` (Norwegian), `es` (Spanish), `se` (Swedish) Example: `locale=en` Click here for a tabular list of available languages per competition.

🏌️‍♂️
Note
In case of disconnection with the feed, use the RESTful api Scorecards Per Round feed to recover any potentially missed data.

Code Samples

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

url = URI("https://api.sportradar.com/golf/trial/stream/pga/scorecards/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/golf/trial/stream/pga/scorecards/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/golf/trial/stream/pga/scorecards/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/golf/trial/stream/pga/scorecards/subscribe?&locale=en&tournament=sd:tournament:9db12181-b55d-4e4f-8c18-936f4c7c7e2d&scoring_system=stroke")

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/golf/trial/stream/pga/scorecards/subscribe",
    params = {'locale': 'en', 'tournament': 'sd:tournament:9db12181-b55d-4e4f-8c18-936f4c7c7e2'},
    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/golf/trial/stream/pga/scorecards/subscribe?&locale=en&tournament=sd:tournament:9db12181-b55d-4e4f-8c18-936f4c7c7e2d&scoring_system=stroke'
  -H 'x-api-key: `{your_api_key}`'

Response Sample

The above commands return json like this.

Data Points

Metadata

Attribute	Parent Element	Type	Description
`locale`	`metadata`	String	Language code ex. `en` (English)
`player`	`metadata`	GUID	Unique ID(s) of a player ex. `sd:player:8ed30358-ddd0-4704-8b72-3e711b73a73e,sr:competitor:21213`
`round`	`metadata`	Integer	Round number
`scoring_system`	`metadata`	String	Scoring system of a tournament `stroke`, `match`, `cup`, `team`
`status`	`metadata`	String	The status of a tournament ex. `inprogress`
`tour`	`metadata`	String	Name of tour ex. `pga`
`tournament`	`metadata`	GUID	Unique ID(s) of a tournament ex. `sd:tournament:0d986e18-cc3d-4391-a37c-903e9097129f,sr:stage:721700`
`tournament_type`	`metadata`	String	Type of a tournament ex. `stroke`
`version`	`metadata`	String	Version of the API ex. `v2`

Player

Attribute	Parent Element	Type	Description
`abbr_name`	`player`	String	Abbreviated name of a player ex. `R.McIlroy`
`amateur`	`player`	Boolean	Signifies a player is in amateur status when `true`
`country`	`player`	String	Country of a player ex. `NORTHERN IRELAND`
`first_name`	`player`	String	First name of a player ex. `Rory`
`id`	`player`	GUID	Unique player ID ex. `da226913-b804-48de-adbf-96e956eb75ac`
`last_name`	`player`	String	Last name of a player ex. `McIlroy`
`name`	`player`	String	Name of a player ex. `McIlroy, Rory`
`sr_id`	`player`	GUID	Unique Sportradar ID of a player ex. `sr:competitor:46702`

Round

Attribute	Parent Element	Type	Description
`id`	`round`	GUID	Unique ID of a round ex. `56983b8a-92e6-40b1-8c53-1b38857d712b`
`number`	`round`	GUID	Number of a round
`status`	`round`	GUID	Status of a round `scheduled`, `inprogress`, `delayed`, `suspended`, `cancelled`, `complete`, `closed`, `reopened`

Scoring

Attribute	Parent Element	Type	Description
`birdies`	`player`	Integer	Number of birdies in a tournament round
`bogeys`	`player`	Integer	Number of bogeys in a tournament round
`double_bogeys`	`player`	Integer	Number of double bogeys in a tournament round
`eagles`	`player`	Integer	Number of eagles in a tournament round
`thru`	`player`	Integer	Number of holes completed in a tournament round
`holes_in_one`	`player`	Integer	Number of holes in one in a tournament round
`other_scores`	`player`	Integer	Number of other scores in a tournament round (non- pars, birdies, eagles, holes in one, bogeys, double bogeys)
`pars`	`player`	Integer	Number of pars in a tournament round
`score`	`player`	Integer	Player score in a round ex. `-4`
`starting_hole`	`player`	Integer	Starting hole of a player within a round ex. `1` or `10`
`strokes`	`player`	Short	Player strokes in a round ex. `68`
`number`	`scores`	Integer	Hole number (1-18)
`par`	`scores`	Integer	Par for a hole ex. `5`
`yardage`	`scores`	Integer	Total yardage of a hole ex. `570`
`strokes`	`scores`	Integer	Number of strokes on a hole for a player

Tournament

Attribute	Parent Element	Type	Description
`coverage`	`tournament`	String	Coverage of a tournament. Click here for a complete breakdown of our tour coverage. ex. `full`
`event_type`	`tournament`	dateTime	Scoring type of a tournament `stroke`, `match`, `cup`, `team`, `mix`
`points`	`tournament`	Integer	Total number of FedEX Cup points for a tournament
`id`	`tournament`	GUID	Unique ID of a tournament ex. `42b7bbc2-858a-4c0d-85dc-b30179bb5e9a`
`name`	`tournament`	String	Name of a tournament ex. `Wells Fargo Championship`
`parent_id`	`tournament`	GUID	Unique parent ID for a tournament. Use this ID to tie reoccurring events across seasons. ex. `5c8d8f92-8da7-4d5d-860b-e820d57ff640` (ID for The Masters)
`purse`	`tournament`	Float	Total prize money for a tournament ex. `15000000.0`
`currency`	`tournament`	String	Prize money currency type of a tournament ex. `USD`
`sr_id`	`tournament`	GUID	Unique Sportradar ID of a tournament ex. `sr:stage:721700`
`status`	`tournament`	GUID	Status of a tournament `scheduled`, `inprogress`, `delayed`, `cancelled`, `created`, `complete`, `closed`, `playoff`, `reopened`
`winning_share`	`tournament`	Float	Prize money for first place in a tournament ex. `1080000.0`