Data API · Players

Get player details

GET/api/v1/datas/players/{id}

Returns one player profile.

Bearer authentication required · service: data_api

Reference 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
id	integer	Required	Player ID Minimum 1.

Query parameters

Parameter	Type	Required	Description
format	string	Required	Response format. Allowed: json, csv, xml.
case	string	Optional	JSON response key style. Default: camelCase. Allowed: camelCase, snake_case.

Response attributes

Attribute	Type	Description
id	integer	Player ID.
name	string\|null	Given name.
surname	string\|null	Family name.
middleName	string	Middle name.
nickname	string	Player nickname.
birthDate	string\|null	Birth date (YYYY-MM-DD).
height	integer\|null	Height in centimeters.
weight	number\|null	Weight in kilograms.
leg	string\|null	Preferred foot.
gender	string\|null	Player gender.
dateCreate	string\|null	Record creation date.
dateUpdate	string\|null	Record update date.
logo	string\|null	Player image URL.
countryId	integer\|null	Primary nationality ID.
countryName	string\|null	Primary nationality name.
position1	string\|null	Primary position.
position2	string\|null	Secondary position.
position3	string\|null	Third position.
providerId	string\|null	Provider identifier.
club	object\|null	Current club.
club.id	integer	Club team ID.
club.name	string\|null	Club team name.
nationalTeam	object\|null	National team.
nationalTeam.id	integer	National team ID.
nationalTeam.name	string\|null	National team name.

Response

200 401 403 404 422

200 · application/json

{ "id": 12, "name": "Alex", "surname": "Player", "middleName": "example", "nickname": "example", "birthDate": "example", "height": 1, "weight": 1.25, "leg": "example", "gender": "example", "dateCreate": "example", "dateUpdate": "example", "logo": "example", "countryId": 1, "countryName": "example", "position1": "Forward", "position2": "example", "position3": "example", "providerId": "example", "club": { "id": 1, "name": "example" }, "nationalTeam": { "id": 1, "name": "example" } }

200 Success
The requested data was returned.

401 Unauthenticated
A valid Bearer token is required. Body carries code UNAUTHENTICATED.

403 Access denied
Body carries code DATA_API_ACCESS_DENIED when the account lacks the API service, or COMPETITION_ACCESS_DENIED when it lacks access to that match or competition.

404 Not found
The requested resource or underlying API data was not found.

422 Validation error
One or more path or query parameters are invalid.