Data API · Change feeds
List player changes
GET/api/v1/datas/player-delta
Returns changed player records in the requested time range; soft-deleted players are excluded.
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. |
| lang | string | Required | Language code. Minimum 1; maximum 10 characters. |
| fromDate | string | Required | Start of the change range. Format: YYYY-MM-DDTHH:MM. |
| toDate | string | Required | End of the change range. Format: YYYY-MM-DDTHH:MM; must not precede fromDate. |
| seasonId | integer | Optional | Season filter. Minimum 1. |
| competitionId | integer | Optional | Competition filter. Minimum 1. |
| 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 | Changed 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. |