Data API · Players
List players
GET/api/v1/datas/players
Returns players available to the authenticated account.
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.
Query parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| format | string | Required | Response format. Allowed: json, csv, xml. |
| page | integer | Optional | Page number. Default: 1. Minimum 1. |
| perPage | integer | Optional | Items per page. Default: 20. Minimum 1; maximum 100. |
| case | string | Optional | JSON response key style. Default: camelCase. Allowed: camelCase, snake_case. |
Response attributes
| Attribute | Type | Description |
|---|---|---|
| items | array | Player records. |
| items[].id | integer | Player ID. |
| items[].name | string|null | Given name. |
| items[].surname | string|null | Family name. |
| items[].middleName | string | Middle name. |
| items[].nickname | string | Player nickname. |
| items[].birthDate | string|null | Birth date (YYYY-MM-DD). |
| items[].height | integer|null | Height in centimeters. |
| items[].weight | number|null | Weight in kilograms. |
| items[].leg | string|null | Preferred foot. |
| items[].gender | string|null | Player gender. |
| items[].dateCreate | string|null | Record creation date. |
| items[].dateUpdate | string|null | Record update date. |
| items[].logo | string|null | Player image URL. |
| items[].countryId | integer|null | Primary nationality ID. |
| items[].countryName | string|null | Primary nationality name. |
| items[].position1 | string|null | Primary position. |
| items[].position2 | string|null | Secondary position. |
| items[].position3 | string|null | Third position. |
| items[].providerId | string|null | Provider identifier. |
| meta | object | Pagination metadata. |
| meta.currentPage | integer | Current page number. |
| meta.perPage | integer | Requested page size. |
| meta.total | integer | Total number of matching records. |
| meta.lastPage | integer | Last available page number. |
| meta.from | integer|null | Position of the first item on this page. |
| meta.to | integer|null | Position of the last item on this page. |
| links | object | Pagination URLs. |
| links.first | string | URL of the first page. |
| links.last | string | URL of the last page. |
| links.previous | string|null | URL of the previous page, when available. |
| links.next | string|null | URL of the next page, when available. |