Stage
Data Dictionary for Golf Stages
The following example shows how the stage metadata is identified. The data tables below will identify the properties available within the metadata.
{
"id": 845656,
"name": "Masters Tournament",
"gender": "male",
"start": "2017-04-06",
"end": "2017-04-09",
"country": {
"id": 16,
"name": "USA"
},
"season": {
"id": 10684,
"name": "2017"
},
"tournament": {
"id": 430,
"name": "European Tour and PGA Tour",
"gender": "male"
},
"sport": {
"id": 3,
"name": "Golf"
},
"meta": {
"currency": {
"code": "stage:currency",
"name": "Currency",
"value": "US Dollar"
},
"cut": {
"code": "stage:cut",
"name": "Cut",
"value": "150"
},
"length": {
"code": "stage:length",
"name": "Length",
"value": "6798"
},
"par": {
"code": "stage:par",
"name": "Par",
"value": "72"
},
"prize": {
"code": "stage:prize",
"name": "Prize",
"value": "10000000"
},
"rounds": {
"code": "stage:rounds",
"name": "Rounds",
"value": "4"
},
"tee-time-round-1": {
"code": "stage:tee-time-round-1",
"name": "Tee Time Round 1",
"value": "2017-04-06T12:00:00Z"
},
"tee-time-round-2": {
"code": "stage:tee-time-round-2",
"name": "Tee Time Round 2",
"value": "2017-04-07T12:00:00Z"
},
"tee-time-round-3": {
"code": "stage:tee-time-round-3",
"name": "Tee Time Round 3",
"value": "2017-04-08T14:20:00Z"
},
"tee-time-round-4": {
"code": "stage:tee-time-round-4",
"name": "Tee Time Round 4",
"value": "2017-04-09T14:05:00Z"
},
"type": {
"code": "stage:type",
"name": "Type",
"value": "Stroke Play"
},
"venue": {
"code": "stage:venue",
"name": "Venue",
"value": "Augusta National Golf Club"
}
},
"updated": "2017-04-04T20:08:31Z",
"venues": [
{
"id": 4193,
"name": "Augusta National Golf Club",
"type": "Golf course",
"country": {
"id": 16,
"name": "USA"
},
"meta": {
"city": {
"code": "venue:city",
"name": "City",
"value": "Augusta"
},
"latitude": {
"code": "venue:latitude",
"name": "Latitude",
"value": "33.501707"
},
"longitude": {
"code": "venue:longitude",
"name": "Longitude",
"value": "-82.022971"
},
"length1": {
"code": "venue:length1",
"name": "Length1",
"value": "407"
},
"length2": {
"code": "venue:length2",
"name": "Length2",
"value": "526"
},
"par1": {
"code": "venue:par1",
"name": "Par1",
"value": "4"
},
"par2": {
"code": "venue:par2",
"name": "Par2",
"value": "5"
}
}
}
],
"links": [
{
"rel": "self",
"href": "http://sport.api.press.net/v1/stage/845656"
}
]
}
<?xml version="1.0" encoding="utf-8" ?>
<pa:sports-content xmlns="http://iptc.org/std/nar/2006-10-01/" xmlns:pa="http://sport-api.pa.press.net/2016-09-30/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<pa:sports-metadata doc-id="http://sport.api.press.net/v1/stage/845656" document-class="pa:stage-detail">
<sports-title>Masters Tournament</sports-title>
</pa:sports-metadata>
<pa:tournament id="tournament.430">
<tournament-division id="season.10684">
<tournament-part id="stage.845656">
<tournament-part-metadata type="pa:stage" start-date-time="2017-04-06" end-date-time="2017-04-09">
<sports-content-codes>
<sports-content-code code-type="pa:sport" code-key="sport:3" code-name="Golf"/>
<sports-content-code code-type="pa:gender" code-key="gender:male" code-name="male"/>
<sports-content-code code-type="pa:tournament" code-key="tournament:430" code-name="European Tour and PGA Tour"/>
<sports-content-code code-type="pa:season" code-key="season:10684" code-name="2017"/>
<sports-content-code code-type="pa:stage" code-key="stage:845656" code-name="Masters Tournament" xsi:type="pa:sportsContentCodeComplexType"></sports-content-code>
</sports-content-codes>
<sports-property formal-name="stage:currency" value="US Dollar"/>
<sports-property formal-name="stage:cut" value="150"/>
<sports-property formal-name="stage:length" value="6798"/>
<sports-property formal-name="stage:par" value="72"/>
<sports-property formal-name="stage:prize" value="10000000"/>
<sports-property formal-name="stage:rounds" value="4"/>
<sports-property formal-name="stage:tee-time-round-1" value="2017-04-06T12:00:00Z"/>
<sports-property formal-name="stage:tee-time-round-2" value="2017-04-07T12:00:00Z"/>
<sports-property formal-name="stage:tee-time-round-3" value="2017-04-08T14:20:00Z"/>
<sports-property formal-name="stage:tee-time-round-4" value="2017-04-09T14:05:00Z"/>
<sports-property formal-name="stage:type" value="Stroke Play"/>
<sports-property formal-name="stage:venue" value="Augusta National Golf Club"/>
<sports-property formal-name="common:updated" value="2017-04-04T20:08:31Z"/>
<name>Masters Tournament</name>
</tournament-part-metadata>
</tournament-part>
</tournament-division>
</pa:tournament>
</pa:sports-content>
Note
Stage venue is an array as it is pluralised to venues. This allows for multiple courses in one stage.
Property Location
| Content Type | Path |
|---|---|
| JSON | $.meta |
| XML | /:sports-content/:tournament/:tournament-division/:tournament-part/:tournament-part-metadata/:sports-property |
| Property | Code | Example | Unit |
|---|---|---|---|
| currency | stage:currency | Euro | String |
| cut | stage:cut | 137 | Number |
| length | stage:length | 7237 | Number |
| par | stage:par | 72 | Number |
| prize | stage:prize | 1000000 | Number |
| projected-cut | stage:projected-cut | 70 | Number |
| rounds | stage:rounds | 4 | Number |
| status-comment | stage:status-comment | Finished | String |
| tee-time-round-1 | stage:tee-time-round-1 | 06:00 (Round Resume at 13:15) | String |
| tee-time-round-2 | stage:tee-time-round-2 | 07:00 (Round Resume at 13:15) | String |
| tee-time-round-3 | stage:tee-time-round-3 | 06:00 | String |
| tee-time-round-4 | stage:tee-time-round-4 | 06:00 | String |
| type | stage:type | Match Play* | String |
| venue | stage:venue | 13th Beach Golf Links | String |
Enumeration values
| Code: stage:type |
|---|
| Matchplay |
| Stableford |
| Stroke Play |
| Greensomes Matchplay |
Matchplay
As the matchplay format contains multiple pairings or teams under an event rather than individual participants, the fixtures within the tournament are presented as individual events of a stage.
For example, calling the stage endpoint for all events within the stage will display pairings and details of the course played on per pairing.
For example:
"id": 2478534,
"name": "Rory McIlroy-Soeren Kjeldsen",
"status": "Finished",
"date": "2017-03-22T14:52:00Z",
"updated": "2017-03-22T18:23:39Z",
"entrants": [
{
"id": 8191367,
"number": 1,
"participant": {
"id": 92598,
"name": "Rory McIlroy",
"firstName": "Rory",
"lastName": "McIlroy",
"gender": "male",
"type": "athlete",
"country": {
"id": 42,
"name": "N. Ireland"
}
},
"results": {
"final-result": {
"code": "result:final-result",
"name": "Final Result",
"value": "lost"
}
}
},
{
"id": 8191368,
"number": 2,
"participant": {
"id": 60079,
"name": "Soeren Kjeldsen",
"firstName": "Soeren",
"lastName": "Kjeldsen",
"gender": "male",
"type": "athlete",
"country": {
"id": 1,
"name": "Denmark"
}
},
"results": {
"final-result": {
"code": "result:final-result",
"name": "Final Result",
"value": "won"
},
"match-play-score": {
"code": "result:match-play-score",
"name": "Match Play Score",
"value": "2&1"
}
Stroke Play & Stableford
A stroke play event has multiple individual players competing and as such, all players are exposed at event level under one event ID. This is the same presentation for Stableford format.
For example, calling the stage endpoint for all events within the stage will display a single event containing all players:
"id": 2430559,
"name": "Open de Portugal",
"status": "2nd Round Started",
"date": "2017-05-11T06:30:00Z",
"updated": "2017-05-12T10:46:26Z",
"entrants": [
{
"id": 8298872,
"number": 1,
"participant": {
"id": 303087,
"name": "Morten Oerum Madsen",
"firstName": "Morten Oerum",
"lastName": "Madsen",
"gender": "male",
"type": "athlete",
"country": {
"id": 1,
"name": "Denmark"
}
},
"results": {
"made-cut": {
"code": "result:made-cut",
"name": "Made Cut",
"value": "yes"
},
"par": {
"code": "result:par",
"name": "Par",
"value": "-1"
},
"rank": {
"code": "result:rank",
"name": "Rank",
"value": "73"
},
"strokes-1st-round": {
"code": "result:strokes-1st-round",
"name": "Strokes 1st Round",
"value": "72"
}
},
"meta": {
"current-hole": {
"code": "event-participant:current-hole",
"name": "Current Hole",
"value": "3"
}
}
},
{
"id": 8298876,
"number": 5,
"participant": {
"id": 844698,
"name": "Tomas Gouveia",
"firstName": "Tomas",
"lastName": "Gouveia",
"gender": "male",
"type": "athlete",
"country": {
"id": 12,
"name": "Portugal"
}
},
"results": {
"made-cut": {
"code": "result:made-cut",
"name": "Made Cut",
"value": "yes"
},
"par": {
"code": "result:par",
"name": "Par",
"value": "5"
},
"rank": {
"code": "result:rank",
"name": "Rank",
"value": "151"
},
"strokes-1st-round": {
"code": "result:strokes-1st-round",
"name": "Strokes 1st Round",
"value": "78"
}
},
"meta": {
"current-hole": {
"code": "event-participant:current-hole",
"name": "Current Hole",
"value": "0"
}
}
},
{
"id": 8298877,
"number": 6,
"participant": {
"id": 679452,
"name": "Luca Cianchetti",
"firstName": "Luca",
"lastName": "Cianchetti",
"gender": "male",
"type": "athlete",
"country": {
"id": 4,
"name": "Italy"
}
},
"results": {
"made-cut": {
"code": "result:made-cut",
"name": "Made Cut",
"value": "yes"
},
"par": {
"code": "result:par",
"name": "Par",
"value": "3"
},
"rank": {
"code": "result:rank",
"name": "Rank",
"value": "138"
},
"strokes-1st-round": {
"code": "result:strokes-1st-round",
"name": "Strokes 1st Round",
"value": "76"
}
},
"meta": {
"current-hole": {
"code": "event-participant:current-hole",
"name": "Current Hole",
"value": "0"
}
}
},
{
"id": 8298878,
"number": 7,
"participant": {
"id": 797748,
"name": "Ewen Ferguson",
"firstName": "Ewen",
"lastName": "Ferguson",
"gender": "male",
"type": "athlete",
"country": {
"id": 15,
"name": "Scotland"
}
},
"results": {
"made-cut": {
"code": "result:made-cut",
"name": "Made Cut",
"value": "yes"
},
"par": {
"code": "result:par",
"name": "Par",
"value": "4"
},
"rank": {
"code": "result:rank",
"name": "Rank",
"value": "144"
},
"strokes-1st-round": {
"code": "result:strokes-1st-round",
"name": "Strokes 1st Round",
"value": "77"
}
},
"meta": {
"current-hole": {
"code": "event-participant:current-hole",
"name": "Current Hole",
"value": "0"
}
}
},
{
Updated over 7 years ago
What’s Next