Match Play Squads

Overview

Use this endpoint to retrieve squads for a match play team tournament.

The response shows top-level squad assignments such as USA and Europe.

It does not include individual match pairings.

Use this endpoint when you need team composition for match play tournaments such as the Ryder Cup.

Request

URL

GET https://{domain}/golf/rest/v1/tournaments/{tournament_id}/match-play-squads

Path parameters

Name	Type	Required	Description
tournament_id	integer	Yes	Tournament identifier.

Example request

Get match play squads

GET /golf/rest/v1/tournaments/12345/match-play-squads HTTP/1.1
Host: {domain}
Authorization: Bearer <JWT_TOKEN>

Use Match Play Schedule when you need match-level scheduling and pairings.

Response example

{
  "squads": [
    {
      "name": "USA",
      "squad_id": 12345,
      "sr_squad_id": "sr:competitor:12345",
      "players": [
        {
          "player_id": 22,
          "sr_player_id": "sr:competitor:22",
          "country": "ENG",
          "display_name": "Tommy Fleetwood",
          "first_name": "Tommy",
          "last_name": "Fleetwood",
          "is_amateur": false,
          "player_pga_tour_id": "30911"
        },
        { ... }
      ]
    },
    { ... }
  ]
}

Response fields

field	type	description	required	old IMGA API equivalent
squads	Array	Array of squads in the tournament	yes	array of squads was a root element of the response
squads[].squad_id	Integer	Numeric ID of the squad	yes	squadNo
squads[].sr_squad_id	String	SR ID of the squad	yes	-
squads[].name	String	Display name of the squad	yes	squadName
squads[].players	Array	List of players in the squad	yes	players
squads[].players[].player_id	Integer	Numeric ID of the player	yes	playerId
squads[].players[].sr_player_id	String	SR ID of the player	yes	-
squads[].players[].country	String	3-character FIFA country code	yes	country
squads[].players[].display_name	String	Full player name used for display	yes	displayName
squads[].players[].first_name	String	First name of the player	yes	firstName
squads[].players[].last_name	String	Last name of the player	yes	lastName
squads[].players[].is_amateur	Boolean	Indicates whether the player is an amateur	yes	isAmateur
squads[].players[].player_pga_tour_id	String	PGA Tour player identifier	no	playerPGA

Related endpoints

• Tournaments list
• Single Tournament
• Match Play Schedule
• Players