Tournaments list

Overview

Use this endpoint to discover golf tournaments across a date range.

Each tournament includes core metadata, round details, venue details, and golf course details.

Use Single Tournament when you already know the tournament_id.

Request

URL

GET https://{domain}/golf/rest/v1/tournaments

Query parameters

Name

Type

Required

Description

date_from

date

Return tournaments that start on or after this date.

date_to

date

Return tournaments that start on or before this date.

status

string

Filter by tournament status. Allowed values: NOT_STARTED, IN_PROGRESS, INTERRUPTED, CANCELED, ENDED, CONFIRMED, MAINTENANCE, SUSPENDED.

data_type

string

Filter by tournament data type. Allowed values: SCHEDULED, TEST.

If you omit all query parameters, the endpoint returns tournaments that start within one month before or after the request date.

Example requests

List tournaments with default date window

GET /golf/rest/v1/tournaments HTTP/1.1
Host: {domain}
Authorization: Bearer <JWT_TOKEN>

List tournaments in a date range

GET /golf/rest/v1/tournaments?date_from=2026-05-01&date_to=2026-05-31&status=IN_PROGRESS HTTP/1.1
Host: {domain}
Authorization: Bearer <JWT_TOKEN>

Response example

{
  "tournaments": [
    {
      "tour": {
        "sr_tour_id": "sr:stage:306287",
        "tour_id": 306287,
        "name": "PGA tour"
      },
      "sr_tournament_id": "sr:stage:1224619",
      "tournament_id": 1224619,
      "tournament_external_id": "PGA-R2025002",
      "name": "Masters Tournament",
      "season": 2025,
      "status": "IN_PROGRESS",
      "start_date": "2025-04-10",
      "end_date": "2025-04-14",
      "start_tee_time": "2025-04-10T04:00:00Z",
      "country_code": "USA",
      "utc_offset": -4,
      "format": "STROKE",
      "endpoint_type": "STROKE",
      "data_type": "SCHEDULED",
      "rounds": [
        {
          "round_id": 12345,
          "sr_round_id": "sr:stage:12345",
          "number": 1,
          "format": "STROKE",
          "type": "REGULAR",
          "status": "IN_PROGRESS",
          "is_playoff": false
        }
      ],
      "golf_courses": [
        {
          "name": "Bethpage State Park, Black Course",
          "course_id": 42178,
          "sr_course_id": "sr:venue:42178",
          "external_course_id": "PGA-6",
          "is_main": true,
          "details": [
            {
              "round_number": 1,
              "holes": [
                {
                  "number": 1,
                  "actual_meters": 440.74,
                  "actual_yardage": 482,
                  "official_meters": 438.91,
                  "official_yardage": 480,
                  "par": 4,
                  "name": "Hole 1 at Bethpage State Park, Black Course",
                  "pin_placement": {
                    "x": 8895.898,
                    "y": 10520.29,
                    "z": 18.081
                  },
                  "tee_boxes": [
                    {
                      "x": 10244.591,
                      "y": 10046.862,
                      "z": 11.087
                    }
                  ]
                }
              ]
            }
          ]
        }
      ],
      "venue": {
        "venue_id": 1234,
        "sr_venue_id": "sr:venue:1245",
        "name": "Bethpage State Park"
      },
      "main_golf_course": {
        "course_id": 42178,
        "sr_course_id": "sr:venue:42178",
        "course_external_id": "PGA-6",
        "name": "Bethpage State Park, Black Course"
      }
    }
  ]
}

Response fields

field

type

description

required

required in PGA

old IMGA API equivalent

tournaments

Array

Array of tournament objects

yes

root

tournaments[].tour

Object

Information about the tour this tournament belongs to

yes

tournaments[].tour.tour_id

Integer

Numeric ID of the tour

yes

tour_id

tournaments[].tour.sr_tour_id

String

SR ID of the tour (e.g., sr:stage:1234)

yes

tournaments[].tour.name

String

Name of the tour

yes

tour

tournaments[].tournament_id

Integer

Numeric ID of the tournament

yes

tournaments[].sr_tournament_id

String

SR ID of the tournament

yes

tournaments[].name

String

Name of the tournament

yes

name

tournaments[].tournament_external_id

String

External federation tournament ID

yes

externalId

tournaments[].season

Integer

Year in which the tournament takes place

yes

year

tournaments[].status

String

Status of the tournament

Possible values are:

- NOT_STARTED - IN_PROGRESS - INTERRUPTED - CANCELED - ENDED - CONFIRMED - MAINTENANCE - SUSPENDED

tournaments[].start_date

Date

Tournament start date (UTC)

yes

startDate

tournaments[].end_date

Date

Tournament end date (UTC)

yes

endDate

tournaments[].start_tee_time

String

Tee time of the first round (UTC ISO-8601)

yes

startTeeTime

tournaments[].country_code

String

Country code (ISO alpha-3, e.g., USA)

yes

countryCode

tournaments[].utc_offset

Integer

UTC offset of tournament location (e.g., -4)

yes

utcOffset

tournaments[].rounds

Array

List of tournament rounds

yes

rounds

tournaments[].rounds[].number

Integer

Round number (1–4, playoff indicated by is_playoff)

yes

roundNo

tournaments[].rounds[].round_id

Integer

Numeric ID of the round

yes

tournaments[].rounds[].sr_round_id

String

ID of the round in SR format

yes

tournaments[].rounds[].format

String

defines the competition structure of the round, i.e. whether scoring is based on total strokes or hole-by-hole results.

Round format:

Values to be specified soon

yes

roundType

tournaments[].rounds[].type

String

defines how the round is played in practice, including whether players compete individually or in teams and how shots are taken.

Round type:

Values to be specified soon

yes

format

tournaments[].rounds[].status

String

Status of the round

Possible values are:

- NOT_STARTED - GROUPINGS - IN_PROGRESS - INTERRUPTED - CANCELED - ENDED - CONFIRMED - MAINTENANCE - SUSPENDED

yes

tournaments[].rounds[].is_playoff

Boolean

Indicates if round is a playoff

yes

isPlayoff

tournaments[].golf_courses

Array

Golf courses used in the tournament

yes

golfCourses

tournaments[].golf_courses[].course_id

Integer

Numeric course ID

yes

courseId

tournaments[].golf_courses[].sr_course_id

String

SR ID of the course

yes

tournaments[].golf_courses[].name

String

Name of the golf course

yes

courseName

tournaments[].golf_courses[].external_course_id

String

External course ID

yes

externalCourseId

tournaments[].golf_courses[].is_main

Boolean

Indicates if this is the main course

yes

isMain

tournaments[].golf_courses[].details

Array

Course details per round

yes

courseDetails

tournaments[].golf_courses[].details[].round_number

Integer

Round number for which details apply

yes

roundNo

tournaments[].golf_courses[].details[].holes

Array

List of holes

yes

holes

tournaments[].golf_courses[].details[].holes[].number

Integer

Hole number

yes

holeNo

tournaments[].golf_courses[].details[].holes[].actual_meters

Decimal

Actual playing distance (meters)

yes

actualMetres

tournaments[].golf_courses[].details[].holes[].actual_yardage

Integer

Actual playing distance (yards)

yes

actualYardage

tournaments[].golf_courses[].details[].holes[].official_meters

Decimal

Official course distance (meters)

yes

officialMetres

tournaments[].golf_courses[].details[].holes[].official_yardage

Integer

Official course distance (yards)

yes

officialYardage

tournaments[].golf_courses[].details[].holes[].par

Integer

Par value of the hole

yes

par

tournaments[].golf_courses[].details[].holes[].name

String

Display name of the hole

yes

displayName

tournaments[].golf_courses[].details[].holes[].pin_placement

Object

Pin coordinates

yes

pinPlacement

tournaments[].golf_courses[].details[].holes[].pin_placement.x

Decimal

X coordinate

yes

tournaments[].golf_courses[].details[].holes[].pin_placement.y

Decimal

Y coordinate

yes

tournaments[].golf_courses[].details[].holes[].pin_placement.z

Decimal

Z coordinate

yes

tournaments[].golf_courses[].details[].holes[].tee_boxes

Array

Tee boxes used for the hole

yes

teeBoxes

tournaments[].golf_courses[].details[].holes[].tee_boxes[].x

Decimal

X coordinate

yes

tournaments[].golf_courses[].details[].holes[].tee_boxes[].y

Decimal

Y coordinate

yes

tournaments[].golf_courses[].details[].holes[].tee_boxes[].z

Decimal

Z coordinate

yes

tournaments[].venue

Object

Venue information

yes

venue

tournaments[].venue.venue_id

Integer

Numeric venue ID

yes

tournaments[].venue.sr_venue_id

String

SR venue ID

yes

tournaments[].venue.name

String

Venue name

yes

venue

tournaments[].main_golf_course

Object

Main course reference. This duplicates the course marked with is_main in golf_courses[].

yes

tournaments[].main_golf_course.course_id

Integer

Main course ID

yes

mainGolfCourseId

tournaments[].main_golf_course.sr_course_id

String

SR ID of main course

yes

tournaments[].main_golf_course.course_external_id

String

External ID of main course

yes

mainExternalGolfCourseId

tournaments[].main_golf_course.name

String

Name of the main golf course

tournaments[].format

String

Tournament format

- STROKE - single players stroke play - TEAM - team stroke play - CUP - match plays with squads - MATCH - match play of single players

yes

format

tournaments[].endpoint_type

String

Information which endpoint types should be connected for getting schedule, leaderboard, hole-by-hole and events

- STROKE - MATCH

yes

tournaments[].data_type

String

Data type of the tournament

- SCHEDULED - TEST

yes

tournamentDataStatus

PreviousLD Golf API Endpoints - Static

NextSingle Tournament

Last updated 4 months ago

Was this helpful?

Overview

Request

Query parameters

Example requests

Response example

Response fields

Related endpoints