Data API · Competitions
Competition and season biographies
GET/api/v1/datas/bio/{competition_id}/{season_id}
Returns the competition, season, teams and player biographies for a season.
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 |
|---|---|---|---|
| competition_id | integer | Required | Competition ID Minimum 1. |
| season_id | integer | Required | Season 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 |
|---|---|---|
| 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. |
| season | object | Season metadata. |
| season.id | integer | Season ID. |
| season.competitionId | integer|null | Competition ID. |
| season.yearSeasonId | integer|null | Year-season ID. |
| season.title | string|null | Season title. |
| season.shortTitle | string|null | Season short title. |
| season.dateStart | string|null | Season start date (YYYY-MM-DD). |
| season.dateEnd | string|null | Season end date (YYYY-MM-DD). |
| season.yearSeasonName | string|null | Year-season label. |
| teams | object | Teams keyed by team ID. |
| teams.{teamId} | object | Biography record for one team. |
| teams.{teamId}.team | object | Team profile. |
| teams.{teamId}.team.id | integer | Team ID. |
| teams.{teamId}.team.name | string|null | Team name. |
| teams.{teamId}.team.logo | string|null | Team logo URL. |
| teams.{teamId}.team.shortName | string|null | Team short name. |
| teams.{teamId}.team.teamType | string|null | Team type (for example Club or National). |
| teams.{teamId}.team.teamStatus | string|null | Team status. |
| teams.{teamId}.team.teamColor | string|null | Team color. |
| teams.{teamId}.team.providerId | string|integer|null | Provider identifier. |
| teams.{teamId}.players | array | Player profiles for the team. |
| teams.{teamId}.players[].id | integer | Player ID. |
| teams.{teamId}.players[].name | string|null | Given name. |
| teams.{teamId}.players[].surname | string|null | Family name. |
| teams.{teamId}.players[].middleName | string | Middle name. |
| teams.{teamId}.players[].nickname | string | Player nickname. |
| teams.{teamId}.players[].birthDate | string|null | Birth date (YYYY-MM-DD). |
| teams.{teamId}.players[].height | integer|null | Height in centimeters. |
| teams.{teamId}.players[].weight | number|null | Weight in kilograms. |
| teams.{teamId}.players[].leg | string|null | Preferred foot. |
| teams.{teamId}.players[].gender | string|null | Player gender. |
| teams.{teamId}.players[].dateCreate | string|null | Record creation date. |
| teams.{teamId}.players[].dateUpdate | string|null | Record update date. |
| teams.{teamId}.players[].logo | string|null | Player image URL. |
| teams.{teamId}.players[].countryId | integer|null | Primary nationality ID. |
| teams.{teamId}.players[].countryName | string|null | Primary nationality name. |
| teams.{teamId}.players[].position1 | string|null | Primary position. |
| teams.{teamId}.players[].position2 | string|null | Secondary position. |
| teams.{teamId}.players[].position3 | string|null | Third position. |
| teams.{teamId}.players[].providerId | string|null | Provider identifier. |