# 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.