Categories

Coverage
Event Formats & Types
Tournament Statuses
Seasonal Statistics
Playoff Data

Integration
Data Workflow
Player Statuses
Statistics
Course Information

.

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-sanctioned 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?

Date values are presented in the ISO 8601 standard format.

Timestamp fields are in UTC. These could include scheduled start times or play-by-play event timestamps. Examples: scheduled="2024-02-11T23:30:00+00:00", created_at="2024-02-11T23:43:20+00:00"

Date-only fields reflect local league convention and are not UTC-adjusted. These could include season start dates and birth dates. Examples: start_date="2024-08-16", date_of_birth="1984-09-22"

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 and has not yet started.
inprogress – The round is actively being played. Live scoring updates should be expected.
delayed – Play has been temporarily stopped due to external factors (e.g., weather). The round is expected to resume on the current date.
suspended - Play has been suspended indefinitely. Unlike a delay, a suspension indicates a longer stoppage of play, that typically will resume the following day.
cancelled – The round has been called off and will not be resumed. No official scoring will be finalized for this round.
complete – All players have finished the round, but statistical validation is still in progress. Scores and stats are subject to change.
closed – The round has concluded and all stats have been fully validated. Data is considered final and official.
reopened – A previously closed round has been reopened for corrections (e.g., scoring or player data updates). Once updated, the round will move back to closed.

Tournament

scheduled - The tournament is scheduled to occur.
inprogress – The tournament is in progress.
delayed – The tournament is 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