Players Endpoint

This endpoint returns information on all players, including:

  • Player ID

  • Player name

  • Country

  • Date of birth (if known)

  • European tour ID

  • PGA tour ID

Endpoint URLs

New endpoint: https://dde-api.data.imgarena.com/golf/players

Required Headers

Key

Value

Accept

application/vnd.imggaming.dde.api+json;version=1

Content-Type

application/json

Authorization

Bearer eyvhaoudfgpdfgo*

Request Parameters

This endpoint currently takes the following parameters:

Parameter

Value

results

used to decide how many results you would like in the response.

offset

used in conjunction with results, if you use &results=100&offset=1 this will give you the first page of 100 results from this endpoint

NB: By passing ‘results’ you will gather the first 100 results by default and by-passing results=100&offset=2 this will return the first 100 on page 2.

If no parameters are passed, the endpoint will return the first 100 players in the database.

Response Model

Player Summary Object

Field Name

Type

Description

playerId

int

The ID of the player that will be referenced across the DDE

playerLPGATourId

int

Player's LPGA tour Id (if relevant)

playerRandAId

int

Players R&A Id (if relevant)

playerEuropeanTourId

string

The European Tour ID of the player (if applicable, if not, null)

playerPGATourId

string

The PGA Tour ID of the player (if applicable, if not, null)

displayName

string

The display name of the player (encoded in UTF-8)

firstName

string

The first name of the player (encoded in UTF-8)

lastName

string

The last name of the player (encoded in UTF-8)

country

string

The ISO country code of the country in which the tournament is taking place

isAmateur

boolean

Is the player an amateur or not

isActive

boolean

gender

string

The gender of the player

dateOfBirth

date

player’s date of birth, null if unknown

{
            "playerSummary": {
                "displayName": "Chris Paisley",
                "playerPGATourId": "34414",
                "playerEuropeanTourId": "37086",
                "dateOfBirth": null,
                "country": "ENG",
                "isAmateur": false,
                "lastName": "Paisley",
                "firstName": "Chris",
                "isActive": true,
                "playerId": 1,
                "playerLPGATourId": null,
                "gender": "Male"
            },
            "europeanTourRanking": null
        },

European Tour Ranking Object

Currently will be null – these docs will be updated when this is available.