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

What’s Next