Data API · Players
Get player statistics in a competition
GET/api/v1/datas/player-stats/{player_id}/{competition_id}
Returns competition, player and statistics objects.
Bearer authentication required · service: data_apiReference only — this page never sends API requests or exposes token controls.
Response formats
When format is listed below, use json for the response documented here, or csv and xml for downloads. JSON uses camelCase by default; set case=snake_case when supported for legacy key names. Nested response fields use dot notation; [] denotes an array item and {key} a dynamic object key.
Path parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| player_id | integer | Required | Player ID Minimum 1. |
| competition_id | integer | Required | Competition ID Minimum 1. |
Query parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| format | string | Required | Response format. Allowed: json, csv, xml. |
| lang | string | Optional | Language code. Default: en. Maximum 10 characters. |
| version | integer | Optional | Statistics version. Minimum 1. |
| case | string | Optional | JSON response key style. Default: camelCase. Allowed: camelCase, snake_case. |
Response attributes
| Attribute | Type | Description |
|---|---|---|
| competition | object | Competition metadata. |
| competition.id | integer | Competition ID. |
| competition.name | string|null | Competition name. |
| competition.shortName | string|null | Competition short name. |
| competition.competitionFormatId | integer|null | Competition format ID. |
| competition.competitionFormatName | string|null | Competition format name. |
| competition.countryId | integer|null | Country ID. |
| competition.countryName | string|null | Country name. |
| competition.logo | string|null | Competition logo URL. |
| competition.providerId | string|integer|null | Provider identifier. |
| competition.gender | string | Derived competition gender. |
| player | object | Player metadata. |
| player.id | integer | Player ID. |
| player.name | string|null | Given name. |
| player.surname | string|null | Family name. |
| player.middleName | string | Middle name. |
| player.nickname | string | Player nickname. |
| player.birthDate | string|null | Birth date (YYYY-MM-DD). |
| player.height | integer|null | Height in centimeters. |
| player.weight | number|null | Weight in kilograms. |
| player.leg | string|null | Preferred foot. |
| player.gender | string|null | Player gender. |
| player.dateCreate | string|null | Record creation date. |
| player.dateUpdate | string|null | Record update date. |
| player.logo | string|null | Player image URL. |
| player.countryId | integer|null | Primary nationality ID. |
| player.countryName | string|null | Primary nationality name. |
| player.position1 | string|null | Primary position. |
| player.position2 | string|null | Secondary position. |
| player.position3 | string|null | Third position. |
| player.providerId | string|null | Provider identifier. |
| statistics | array | Statistics for the player by season. |
| statistics[].season | string|null | Season label. |
| statistics[].general | object | General season totals. |
| statistics[].general.{statistic} | number|string|null | A general statistic keyed by its source name. |
| statistics[].params | object | Detailed statistics keyed by their source name. |
| statistics[].params.{statistic} | number|string|null | A detailed statistic keyed by its source name. |