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 TypePath
JSON$.meta
XML/:sports-content/:tournament/:tournament-division/:tournament-part/:tournament-part-metadata/:sports-property
PropertyCodeExampleUnit
currencystage:currencyEuroString
cutstage:cut137Number
lengthstage:length7237Number
parstage:par72Number
prizestage:prize1000000Number
projected-cutstage:projected-cut70Number
roundsstage:rounds4Number
status-commentstage:status-commentFinishedString
tee-time-round-1stage:tee-time-round-106:00
(Round Resume at 13:15)
String
tee-time-round-2stage:tee-time-round-207:00
(Round Resume at 13:15)
String
tee-time-round-3stage:tee-time-round-306:00String
tee-time-round-4stage:tee-time-round-406:00String
typestage:typeMatch Play*String
venuestage:venue13th Beach Golf LinksString

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"
            }
          }
        },
        {

What’s Next