FAQs

Categories

.

Coverage

What tours are covered?

Coverage information for golf can be found here.

Why do I see an event within more than tour?

In some cases, events are co-sactioned by multiple tours. For example, The Masters may appear within both the PGA and Euro Tournament Schedule endpoints, as it is co-sanctioned by each tour.

Integration

What format are date fields presented in?

When we present date only values we present these in the ISO 8601 standard format.

ex: 2013-04-03

We use these for attributes that have date and no time (such as birthdate). For more information: https://en.wikipedia.org/wiki/ISO_8601

What format are the date/time fields presented in?

All of our Date/Time attributes are in UTC, presented in the ISO 8601 standard format.

ex: 2013-04-03T18:15:00+00:00

For more information: https://en.wikipedia.org/wiki/ISO_8601

How do I locate the TTL (Time to Live)/cache on an API endpoint?

The cache (in seconds) can be accessed in the returned header information on each RESTful API call, under cache-control.

ex. cache-control: max-age=1, public, s-maxage=1 or
cache-control: public, must-revalidate, max-age=120

Event Formats & Types

What are the valid Event types?

• stroke
• match
• cup
• team
• mix

What are the valid Match formats?

• singles
• fourball
• foursomes

What are the valid Match types?

• regular
• semifinal
• championship
• consolation

How does a mixed format tournament (event_type="mix") behave?

See the below samples for complete files of a mixed tournament. (usga/v3/en/2019/tournaments/ea983f1d-5379-4c79-a0f1-39f29f0aa870)

• Scorecards by Round (Round 1) - XML - JSON
• Scorecards by Round (Round 2) - XML - JSON
• Scorecards by Round (Round 3) - XML - JSON
• Scorecards by Round (Round 4) - XML - JSON
• Tournament Leaderboard - XML - JSON
• Tournament Summary - XML - JSON

Data Workflow

How can I find timings for data entry updates?

Our Golf Data Entry Workflow section covers data availability updates. This includes updates for tee times, cut lines, stat validation, and more.

Player Statuses

What are the valid player statuses?

Player status relates to a player’s status for a particular tournament. If the player is still competing in a tournament, no status attribute will appear.

Here are all remaining player statuses and their definitions:

• CUT – The player has missed the cut of a tournament
• WD – The player has withdrawn from a tournament
• MDF – The player made the cut, but did not finish the tournament
• DQ – The player has been disqualified
• DNS – The player was scheduled to compete in the tournament, but never started

<player id="92544280-0438-4f43-a5f3-f3a21ea55157" first_name="Brian" last_name="Harman" country="UNITED STATES" 
  position="53" tied="true" score="5" strokes="149" status="CUT" abbr_name="B.Harman">

Tournament Statuses

What are the valid tournament and round statuses and their definitions?

Round

• scheduled - The round is scheduled to occur.
• inprogress – The round is in progress.
• delayed – The round has been delayed.
• suspended - The round was suspended.
• cancelled – The round was cancelled.
• complete – The round is over, but stat validation is not complete.
• closed – The round is over and the stats have been validated.
• reopened – The round stats are in the process of being corrected.

Tournament

• scheduled - The tournament is scheduled to occur.
• inprogress – The tournament is in progress.
• delayed – The tournament was delayed.
• cancelled – The tournament was cancelled.
• created – The tournament has been created and we have begun logging the field and tee times when available.
• complete – The tournament is over, but stat validation is not complete.
• closed – The tournament is over and the stats have been validated.
• playoff – The tournament is in a playoff.
• reopened – The tournament stats are in the process of being corrected.

What are the possible values for season status?

• scheduled
• inprogress
• closed

Statistics

How do you handle the points reset associated with the Tour Championship and the Fed Ex Cup?

The top 30 players have a point reset applied. We reset the point total for each player involved in the Tour Championship tournament. Players ranked 31 and above will have their points reflect their correct total prior to the reset applied to those players who qualified.

After the Tour Championship, the top 30 player’s points will reflect the reset value plus points earned in the Tour Championship tournament.

Seasonal Statistics

Do you provide season statistics for all golfers?

We provide season statistics for all golfers who have earned Fed Ex Cup points. Season statistics are validated and corrected on a weekly basis. World Golf Rank for each season will reflect the players ranking following the completion of the Tour Championship, not the end of the year.

For more information on timing, please see our Golf Data Entry Workflow.

Course Information

Where do I find a list of golfers participating in a particular tournament?

The Tournament Summary feed gives you a list of all golfers participating in a tournament.

Course information in the Tournament Schedule endpoint does not match the course information for a specific tournament. Why is that?

A full list of course attributes can be found in 2 feeds: Tournament Schedule and Tournament Summary.

The Tournament Schedule endpoint provides the generic course layout and yardage. Courses can be changed for a specific tournament.

The Tournament Summary endpoint provides the official course layout and yardage for a specific tournament.

Playoff Data

How is playoff data represented?

Playoff data will appear within the Tournament Leaderboard and Scorecards Per Round endpoints.

In Tournament Leaderboard, a playoff element will appear that includes all golfers taking part in the playoff. As with other rounds within the tournament, the playoff section will include the golfer’s current score as well as a summary of their current round score. An example is presented below.

<playoff>
  <player first_name="Jordan" last_name="Spieth" country="UNITED STATES" id="3e4963cb-6e80-4393-85cf-2aecec453c4a" position="1" score="-1" strokes="10">
    <rounds>
      <round score="-1" strokes="10" thru="3" eagles="0" birdies="1" pars="2" bogeys="0" double_bogeys="0" other_scores="0" holes_in_one="0" sequence="1"/>
    </rounds>
  </player>
  <player first_name="Sean" last_name="O'Hair" country="UNITED STATES" id="e260788d-657a-4d72-9766-82f27a9c66ba" position="2" tied="true" score="0" strokes="11">
    <rounds>
      <round score="0" strokes="11" thru="3" eagles="0" birdies="0" pars="3" bogeys="0" double_bogeys="0" other_scores="0" holes_in_one="0" sequence="1"/>
    </rounds>
  </player>
  <player first_name="Patrick" last_name="Reed" country="UNITED STATES" id="12195ed9-3fcd-486a-86b4-1ec726d201cd" position="2" tied="true" score="0" strokes="11">
    <rounds>
      <round score="0" strokes="11" thru="3" eagles="0" birdies="0" pars="3" bogeys="0" double_bogeys="0" other_scores="0" holes_in_one="0" sequence="1"/>
    </rounds>
  </player>
</playoff>

If a tournament plays a complete playoff round to determine the winner, the golfer’s round information will also be available in the Scorecards Per Round endpoint. You can generate the Scorecards Per Round by substituting the rounds parameter with playoff, like within the following example:

golf/trial/v3/scorecards/pga/2017/tournaments/d0a413de-627a-481c-825a-142ec55239a5/playoff/1/scores.xml?api_key=[API_KEY]

🙋

More questions?

Reach out to [email protected] for further assistance.