Players

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

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. Default is 100.
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

Response Model

Player Summary Object

Field Name	Type	Description
playerId	integer	The ID of the player that will be referenced across the DDE
playerEuropeanTourId	string	The European Tour ID of the player (if applicable, if not, null)
playerRandAId	integer	Players R&A Id (if relevant)
playerPGATourId	integer	The PGA Tour ID of the player (if applicable, if not, null)
playerLivId	integer	The Liv 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)
pending	boolean	Pending flag if the player needs to be verified by our support team. Note that if this flag is true, the player name will be marked as "Unknown".
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

```json
 "players": [
        {
            "europeanTourRanking": null,
            "playerSummary": {
                "country": "ENG",
                "dateOfBirth": null,
                "displayName": "Chris Paisley",
                "firstName": "Chris",
                "gender": "Male",
                "isActive": true,
                "isAmateur": false,
                "lastName": "Paisley",
                "pending": false,
                "playerEuropeanTourId": "37086",
                "playerId": 1,
                "playerLPGATourId": null,
                "playerPGATourId": "34414",
                "playerLivId": null,
                "playerRandAId": null
            }
        },
        {
            "europeanTourRanking": null,
            "playerSummary": {
                "country": "ITA",
                "dateOfBirth": null,
                "displayName": "Nino Bertasio",
                "firstName": "Nino",
                "gender": "Male",
                "isActive": true,
                "isAmateur": false,
                "lastName": "Bertasio",
                "pending": false,
                "playerEuropeanTourId": "35602",
                "playerId": 2,
                "playerLPGATourId": null,
                "playerPGATourId": "32252",
                "playerLivId": null,
                "playerRandAId": null
            }
        },
        {
            "europeanTourRanking": null,
            "playerSummary": {
                "country": "ENG",
                "dateOfBirth": null,
                "displayName": "Matt Wallace",
                "firstName": "Matt",
                "gender": "Male",
                "isActive": true,
                "isAmateur": false,
                "lastName": "Wallace",
                "pending": false,
                "playerEuropeanTourId": "39617",
                "playerId": 3,
                "playerLPGATourId": null,
                "playerPGATourId": "48887",
                "playerLivId": null,
                "playerRandAId": "142323"
            }
        },
        {
            "europeanTourRanking": null,
            "playerSummary": {
                "country": "BEL",
                "dateOfBirth": null,
                "displayName": "Thomas Detry",
                "firstName": "Thomas",
                "gender": "Male",
                "isActive": true,
                "isAmateur": false,
                "lastName": "Detry",
                "playerEuropeanTourId": "37017",
                "playerId": 4,
                "playerLPGATourId": null,
                "playerPGATourId": "33653",
                "playerLivId": null,
                "playerRandAId": "146598"
            }
```

European Tour Ranking Object

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

Doc navigation

← Live Events