Table of Contents

Getting Started

Coverage

What tours are covered?

Coverage information for golf can be found here.

Why do I see an event in more than one 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

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.

For per-feed polling intervals and how often each endpoint refreshes, see the Update Frequencies guide.

Back to top ↑

Tournament Data

Event Formats & Types

What are the valid Event types?

Here are the valid event types:

• stroke
• match
• cup
• team
• mix

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

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

For handling team and mixed-format events end to end, see the Monitoring Team Events scenario guide.

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.

For how these statuses progress during an event — including polling strategy and the full status lifecycle — see the Tournament Status Workflow guide.

What are the possible values for season status?

Here are the valid season status values:

• scheduled
• inprogress
• closed

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">

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

For a step-by-step walkthrough of detecting and following a playoff, see the Tracking Playoffs scenario guide.

Back to top ↑

Reference Data

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 players' 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 player's 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.

For retrieving player profiles and season statistics step by step, see the Player Details and Statistics scenario guide.

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.

Back to top ↑