FAQs

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"

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

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

What are the valid Event types?

Here are the valid event types:

• stroke
• match
• cup
• team

What are the valid Match formats?

Here are the valid match formats:

• singles
• fourball
• foursomes

What are the valid Match types?

Here are the valid match types:

• regular
• semifinal
• championship
• consolation

What are the valid player statuses?

The only player status revolves around a player’s status for a particular tournament. If the player is still competing in the 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

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.

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 in the Tournament Schedule feed 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 feed provides the generic course layout and yardage. Courses can be changed for a specific tournament. To find the official course layout and yardage for a specific tournament, you need to use the Tournament Summary feed.

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 will 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.

How is playoff data represented within the feeds?

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 Scorecard Per Round feed. You can generate the Scorecard By Round by substituting the “rounds” variable with “playoff”, like within the following example:

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

Note that, for select game-centric endpoints, the TTL may adjust when an event is live. This information is available for each endpoint on our developer portal.