Lineups and formations
1.1 Requesting lineup and formation data
One of the most vital parts of a well-designed football application is displaying lineups and formations. To display lineups correctly, you need to retrieve data using the Sportmonks Football API. The key includes for fetching lineup and formation data are:
formations→ Retrieves the formations of both teams.lineups→ Provides detailed player lineup data.sidelined.sideline→ Lists injured or suspended players.
1.1 Requesting formations
Each team starts their match in a specific formation. Formations dictate the positioning of players on the field and are essential for lineup visualisation. There are many formations available (e.g., 4-4-2, 4-3-3, 3-5-2). You can find every known formation in the definitions section.
To request formations, use the formations include in your API request:
https://api.sportmonks.com/v3/football/fixtures/19380879?api_token=YOURTOKEN&include=formationsResponse
{
"data": {
"id": 19380879,
"sport_id": 1,
"league_id": 2,
"season_id": 23619,
"stage_id": 77471316,
"group_id": null,
"aggregate_id": 58589,
"round_id": null,
"state_id": 5,
"venue_id": 151,
"name": "Manchester City vs Real Madrid",
"starting_at": "2025-02-11 20:00:00",
"result_info": "Real Madrid won after full-time.",
"leg": "1/2",
"details": null,
"length": 90,
"placeholder": false,
"has_odds": true,
"has_premium_odds": true,
"starting_at_timestamp": 1739304000,
"formations": [
{
"id": 8405326,
"fixture_id": 19380879,
"participant_id": 3468,
"formation": "4-4-2",
"location": "away"
},
{
"id": 8405325,
"fixture_id": 19380879,
"participant_id": 9,
"formation": "4-1-4-1",
"location": "home"
}
]
},1.2 Requesting lineups
A lineup consists of the starting eleven players and their positions within the chosen formation. This information helps users display who is playing and where.
To request lineups, use the lineups include in your API request:
https://api.sportmonks.com/v3/football/fixtures/19380879?api_token=YOURTOKEN&include=lineupsResponse
{
"data": {
"id": 19380879,
"sport_id": 1,
"league_id": 2,
"season_id": 23619,
"stage_id": 77471316,
"group_id": null,
"aggregate_id": 58589,
"round_id": null,
"state_id": 5,
"venue_id": 151,
"name": "Manchester City vs Real Madrid",
"starting_at": "2025-02-11 20:00:00",
"result_info": "Real Madrid won after full-time.",
"leg": "1/2",
"details": null,
"length": 90,
"placeholder": false,
"has_odds": true,
"has_premium_odds": true,
"starting_at_timestamp": 1739304000,
"lineups": [
{
"id": 14668918923,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 162536,
"team_id": 9,
"position_id": 25,
"formation_field": "2:2",
"type_id": 11,
"formation_position": 3,
"player_name": "Rúben Santos Gato Alves Dias",
"jersey_number": 3
},
{
"id": 14668923251,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 982,
"team_id": 9,
"position_id": 26,
"formation_field": "3:1",
"type_id": 11,
"formation_position": 6,
"player_name": "John Stones",
"jersey_number": 5
},
{
"id": 14668923252,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 1869,
"team_id": 9,
"position_id": 25,
"formation_field": "2:3",
"type_id": 11,
"formation_position": 4,
"player_name": "Nathan Aké",
"jersey_number": 6
},
{
"id": 14668923253,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 294000,
"team_id": 9,
"position_id": 27,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Omar Marmoush",
"jersey_number": 7
},
{
"id": 14668908843,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 73147,
"team_id": 9,
"position_id": 26,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Mateo Kovačić",
"jersey_number": 8
},
{
"id": 14668908844,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 154421,
"team_id": 9,
"position_id": 27,
"formation_field": "5:1",
"type_id": 11,
"formation_position": 11,
"player_name": "Erling Håland",
"jersey_number": 9
},
{
"id": 14668923254,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 1116,
"team_id": 9,
"position_id": 26,
"formation_field": "4:4",
"type_id": 11,
"formation_position": 10,
"player_name": "Jack Grealish",
"jersey_number": 10
},
{
"id": 14668923255,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 23697990,
"team_id": 9,
"position_id": 27,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Jeremy Doku",
"jersey_number": 11
},
{
"id": 14668923256,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 23269737,
"team_id": 9,
"position_id": 26,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Nicolás González Iglesias",
"jersey_number": 14
},
{
"id": 14668908845,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 1371,
"team_id": 9,
"position_id": 26,
"formation_field": "4:2",
"type_id": 11,
"formation_position": 8,
"player_name": "Kevin De Bruyne",
"jersey_number": 17
},
{
"id": 14668923257,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 34594,
"team_id": 9,
"position_id": 24,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Stefan Ortega Moreno",
"jersey_number": 18
},
{
"id": 14668923258,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 4842,
"team_id": 9,
"position_id": 26,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "İlkay Gündoğan",
"jersey_number": 19
},
{
"id": 14668908846,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 96353,
"team_id": 9,
"position_id": 26,
"formation_field": "4:3",
"type_id": 11,
"formation_position": 9,
"player_name": "Bernardo Mota Veiga de Carvalho e Silva",
"jersey_number": 20
},
{
"id": 14668908847,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 24838191,
"team_id": 9,
"position_id": 25,
"formation_field": "2:4",
"type_id": 11,
"formation_position": 5,
"player_name": "Joško Gvardiol",
"jersey_number": 24
},
{
"id": 14668908848,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 198062,
"team_id": 9,
"position_id": 25,
"formation_field": "2:1",
"type_id": 11,
"formation_position": 2,
"player_name": "Manuel Obafemi Akanji",
"jersey_number": 25
},
{
"id": 14668908849,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 37527169,
"team_id": 9,
"position_id": 26,
"formation_field": "4:1",
"type_id": 11,
"formation_position": 7,
"player_name": "Sávio Moreira de Oliveira",
"jersey_number": 26
},
{
"id": 14668908850,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 21781428,
"team_id": 9,
"position_id": 26,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Matheus Luiz Nunes",
"jersey_number": 27
},
{
"id": 14668918924,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 159142,
"team_id": 9,
"position_id": 24,
"formation_field": "1:1",
"type_id": 11,
"formation_position": 1,
"player_name": "Ederson Santana de Moraes",
"jersey_number": 31
},
{
"id": 14668923259,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 37623459,
"team_id": 9,
"position_id": 25,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Abdukodir Khusanov",
"jersey_number": 45
},
{
"id": 14668908852,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 336133,
"team_id": 9,
"position_id": 26,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Philip Foden",
"jersey_number": 47
},
{
"id": 14668923260,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 37562487,
"team_id": 9,
"position_id": 26,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Nico O'Reilly",
"jersey_number": 75
},
{
"id": 14668923261,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 37459073,
"team_id": 9,
"position_id": 25,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Rico Lewis",
"jersey_number": 82
},
{
"id": 14668923262,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 28575676,
"team_id": 9,
"position_id": 26,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "James Mcatee",
"jersey_number": 87
},
{
"id": 14668908831,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 1314,
"team_id": 3468,
"position_id": 24,
"formation_field": "1:1",
"type_id": 11,
"formation_position": 1,
"player_name": "Thibaut Courtois",
"jersey_number": 1
},
{
"id": 14668908832,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 37255840,
"team_id": 3468,
"position_id": 26,
"formation_field": "3:1",
"type_id": 11,
"formation_position": 9,
"player_name": "Jude Bellingham",
"jersey_number": 5
},
{
"id": 14668916254,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 23688922,
"team_id": 3468,
"position_id": 26,
"formation_field": "3:3",
"type_id": 11,
"formation_position": 7,
"player_name": "Eduardo Camavinga",
"jersey_number": 6
},
{
"id": 14668908833,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 600687,
"team_id": 3468,
"position_id": 27,
"formation_field": "4:1",
"type_id": 11,
"formation_position": 11,
"player_name": "Vinícius José Paixão de Oliveira Júnior",
"jersey_number": 7
},
{
"id": 14668908834,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 260862,
"team_id": 3468,
"position_id": 25,
"formation_field": "2:4",
"type_id": 11,
"formation_position": 2,
"player_name": "Federico Santiago Valverde Dipetta",
"jersey_number": 8
},
{
"id": 14668908835,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 96611,
"team_id": 3468,
"position_id": 27,
"formation_field": "4:2",
"type_id": 11,
"formation_position": 10,
"player_name": "Kylian Mbappé Lottin",
"jersey_number": 9
},
{
"id": 14668923239,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 268,
"team_id": 3468,
"position_id": 26,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Luka Modrić",
"jersey_number": 10
},
{
"id": 14668908836,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 7346228,
"team_id": 3468,
"position_id": 26,
"formation_field": "3:4",
"type_id": 11,
"formation_position": 6,
"player_name": "Rodrygo Silva de Goes",
"jersey_number": 11
},
{
"id": 14668923240,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 205983,
"team_id": 3468,
"position_id": 24,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Andriy Lunin",
"jersey_number": 13
},
{
"id": 14668908837,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 5270371,
"team_id": 3468,
"position_id": 25,
"formation_field": "2:3",
"type_id": 11,
"formation_position": 3,
"player_name": "Aurélien Tchouaméni",
"jersey_number": 14
},
{
"id": 14668923241,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 37547467,
"team_id": 3468,
"position_id": 26,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Arda Guler",
"jersey_number": 15
},
{
"id": 14668923242,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 37647009,
"team_id": 3468,
"position_id": 27,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Endrick Felipe Moreira de Sousa",
"jersey_number": 16
},
{
"id": 14668923243,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 32536,
"team_id": 3468,
"position_id": 25,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Jesús Vallejo Lázaro",
"jersey_number": 18
},
{
"id": 14668908839,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 186734,
"team_id": 3468,
"position_id": 26,
"formation_field": "3:2",
"type_id": 11,
"formation_position": 8,
"player_name": "Daniel Ceballos Fernández",
"jersey_number": 19
},
{
"id": 14668923244,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 537666,
"team_id": 3468,
"position_id": 25,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Francisco José García Torres",
"jersey_number": 20
},
{
"id": 14668923245,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 340342,
"team_id": 3468,
"position_id": 26,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Brahim Abdelkader Diaz",
"jersey_number": 21
},
{
"id": 14668922399,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 98903,
"team_id": 3468,
"position_id": 25,
"formation_field": "2:1",
"type_id": 11,
"formation_position": 5,
"player_name": "Ferland Mendy",
"jersey_number": 23
},
{
"id": 14668923246,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 37593253,
"team_id": 3468,
"position_id": 27,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Gonzalo García Torres",
"jersey_number": 30
},
{
"id": 14668923247,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 37656089,
"team_id": 3468,
"position_id": 25,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Jacobo Ramón Naveros",
"jersey_number": 31
},
{
"id": 14668923248,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 37656203,
"team_id": 3468,
"position_id": 24,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Sergio Mestre Sánchez",
"jersey_number": 34
},
{
"id": 14668908841,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 37596373,
"team_id": 3468,
"position_id": 25,
"formation_field": "2:2",
"type_id": 11,
"formation_position": 4,
"player_name": "Raúl Asencio del Rosario",
"jersey_number": 35
},
{
"id": 14668923249,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 37656783,
"team_id": 3468,
"position_id": 26,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "José María Andrés Baixauli",
"jersey_number": 36
},
{
"id": 14668923250,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 37529826,
"team_id": 3468,
"position_id": 25,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Lorenzo Aguado Herrera",
"jersey_number": 39
}
]
},1.3 Requesting detailed positions
Each player has a detailed position (e.g., Goalkeeper, Right-back, Central Midfield, Attacker). This is determined by the team’s formation and tactics.
To request detailed positions for players, use the nested include lineups.detailedposition:
https://api.sportmonks.com/v3/football/fixtures/19380879?api_token=YOURTOKEN&include=lineups.detailedpositionResponse
{
"data": {
"id": 19380879,
"sport_id": 1,
"league_id": 2,
"season_id": 23619,
"stage_id": 77471316,
"group_id": null,
"aggregate_id": 58589,
"round_id": null,
"state_id": 5,
"venue_id": 151,
"name": "Manchester City vs Real Madrid",
"starting_at": "2025-02-11 20:00:00",
"result_info": "Real Madrid won after full-time.",
"leg": "1/2",
"details": null,
"length": 90,
"placeholder": false,
"has_odds": true,
"has_premium_odds": true,
"starting_at_timestamp": 1739304000,
"lineups": [
{
"id": 14668918923,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 162536,
"team_id": 9,
"position_id": 25,
"formation_field": "2:2",
"type_id": 11,
"formation_position": 3,
"player_name": "Rúben Santos Gato Alves Dias",
"jersey_number": 3,
"detailedposition": {
"id": 148,
"name": "Centre Back",
"code": "centre-back",
"developer_name": "CENTRE_BACK",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14668923251,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 982,
"team_id": 9,
"position_id": 26,
"formation_field": "3:1",
"type_id": 11,
"formation_position": 6,
"player_name": "John Stones",
"jersey_number": 5,
"detailedposition": {
"id": 149,
"name": "Defensive Midfield",
"code": "defensive-midfied",
"developer_name": "DEFENSIVE_MIDFIELD",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14668923252,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 1869,
"team_id": 9,
"position_id": 25,
"formation_field": "2:3",
"type_id": 11,
"formation_position": 4,
"player_name": "Nathan Aké",
"jersey_number": 6,
"detailedposition": {
"id": 148,
"name": "Centre Back",
"code": "centre-back",
"developer_name": "CENTRE_BACK",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14668923253,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 294000,
"team_id": 9,
"position_id": 27,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Omar Marmoush",
"jersey_number": 7,
"detailedposition": null
},
{
"id": 14668908843,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 73147,
"team_id": 9,
"position_id": 26,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Mateo Kovačić",
"jersey_number": 8,
"detailedposition": null
},
{
"id": 14668908844,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 154421,
"team_id": 9,
"position_id": 27,
"formation_field": "5:1",
"type_id": 11,
"formation_position": 11,
"player_name": "Erling Håland",
"jersey_number": 9,
"detailedposition": {
"id": 27,
"name": "Attacker",
"code": "attacker",
"developer_name": "ATTACKER",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14668923254,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 1116,
"team_id": 9,
"position_id": 26,
"formation_field": "4:4",
"type_id": 11,
"formation_position": 10,
"player_name": "Jack Grealish",
"jersey_number": 10,
"detailedposition": {
"id": 157,
"name": "Left Midfield",
"code": "left-midfield",
"developer_name": "LEFT_MIDFIELD",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14668923255,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 23697990,
"team_id": 9,
"position_id": 27,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Jeremy Doku",
"jersey_number": 11,
"detailedposition": null
},
{
"id": 14668923256,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 23269737,
"team_id": 9,
"position_id": 26,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Nicolás González Iglesias",
"jersey_number": 14,
"detailedposition": null
},
{
"id": 14668908845,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 1371,
"team_id": 9,
"position_id": 26,
"formation_field": "4:2",
"type_id": 11,
"formation_position": 8,
"player_name": "Kevin De Bruyne",
"jersey_number": 17,
"detailedposition": {
"id": 153,
"name": "Central Midfield",
"code": "central-midfied",
"developer_name": "CENTRAL_MIDFIELD",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14668923257,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 34594,
"team_id": 9,
"position_id": 24,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Stefan Ortega Moreno",
"jersey_number": 18,
"detailedposition": null
},
{
"id": 14668923258,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 4842,
"team_id": 9,
"position_id": 26,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "İlkay Gündoğan",
"jersey_number": 19,
"detailedposition": null
},
{
"id": 14668908846,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 96353,
"team_id": 9,
"position_id": 26,
"formation_field": "4:3",
"type_id": 11,
"formation_position": 9,
"player_name": "Bernardo Mota Veiga de Carvalho e Silva",
"jersey_number": 20,
"detailedposition": {
"id": 153,
"name": "Central Midfield",
"code": "central-midfied",
"developer_name": "CENTRAL_MIDFIELD",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14668908847,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 24838191,
"team_id": 9,
"position_id": 25,
"formation_field": "2:4",
"type_id": 11,
"formation_position": 5,
"player_name": "Joško Gvardiol",
"jersey_number": 24,
"detailedposition": {
"id": 155,
"name": "Left Back",
"code": "left-back",
"developer_name": "LEFT_BACK",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14668908848,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 198062,
"team_id": 9,
"position_id": 25,
"formation_field": "2:1",
"type_id": 11,
"formation_position": 2,
"player_name": "Manuel Obafemi Akanji",
"jersey_number": 25,
"detailedposition": {
"id": 154,
"name": "Right Back",
"code": "right-back",
"developer_name": "RIGHT_BACK",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14668908849,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 37527169,
"team_id": 9,
"position_id": 26,
"formation_field": "4:1",
"type_id": 11,
"formation_position": 7,
"player_name": "Sávio Moreira de Oliveira",
"jersey_number": 26,
"detailedposition": {
"id": 158,
"name": "Right Midfield",
"code": "right-midfield",
"developer_name": "RIGHT_MIDFIELD",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14668908850,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 21781428,
"team_id": 9,
"position_id": 26,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Matheus Luiz Nunes",
"jersey_number": 27,
"detailedposition": null
},
{
"id": 14668918924,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 159142,
"team_id": 9,
"position_id": 24,
"formation_field": "1:1",
"type_id": 11,
"formation_position": 1,
"player_name": "Ederson Santana de Moraes",
"jersey_number": 31,
"detailedposition": {
"id": 24,
"name": "Goalkeeper",
"code": "goalkeeper",
"developer_name": "GOALKEEPER",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14668923259,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 37623459,
"team_id": 9,
"position_id": 25,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Abdukodir Khusanov",
"jersey_number": 45,
"detailedposition": null
},
{
"id": 14668908852,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 336133,
"team_id": 9,
"position_id": 26,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Philip Foden",
"jersey_number": 47,
"detailedposition": null
},
{
"id": 14668923260,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 37562487,
"team_id": 9,
"position_id": 26,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Nico O'Reilly",
"jersey_number": 75,
"detailedposition": null
},
{
"id": 14668923261,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 37459073,
"team_id": 9,
"position_id": 25,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Rico Lewis",
"jersey_number": 82,
"detailedposition": null
},
{
"id": 14668923262,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 28575676,
"team_id": 9,
"position_id": 26,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "James Mcatee",
"jersey_number": 87,
"detailedposition": null
},
{
"id": 14668908831,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 1314,
"team_id": 3468,
"position_id": 24,
"formation_field": "1:1",
"type_id": 11,
"formation_position": 1,
"player_name": "Thibaut Courtois",
"jersey_number": 1,
"detailedposition": {
"id": 24,
"name": "Goalkeeper",
"code": "goalkeeper",
"developer_name": "GOALKEEPER",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14668908832,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 37255840,
"team_id": 3468,
"position_id": 26,
"formation_field": "3:1",
"type_id": 11,
"formation_position": 9,
"player_name": "Jude Bellingham",
"jersey_number": 5,
"detailedposition": {
"id": 157,
"name": "Left Midfield",
"code": "left-midfield",
"developer_name": "LEFT_MIDFIELD",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14668916254,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 23688922,
"team_id": 3468,
"position_id": 26,
"formation_field": "3:3",
"type_id": 11,
"formation_position": 7,
"player_name": "Eduardo Camavinga",
"jersey_number": 6,
"detailedposition": {
"id": 153,
"name": "Central Midfield",
"code": "central-midfied",
"developer_name": "CENTRAL_MIDFIELD",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14668908833,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 600687,
"team_id": 3468,
"position_id": 27,
"formation_field": "4:1",
"type_id": 11,
"formation_position": 11,
"player_name": "Vinícius José Paixão de Oliveira Júnior",
"jersey_number": 7,
"detailedposition": {
"id": 27,
"name": "Attacker",
"code": "attacker",
"developer_name": "ATTACKER",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14668908834,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 260862,
"team_id": 3468,
"position_id": 25,
"formation_field": "2:4",
"type_id": 11,
"formation_position": 2,
"player_name": "Federico Santiago Valverde Dipetta",
"jersey_number": 8,
"detailedposition": {
"id": 154,
"name": "Right Back",
"code": "right-back",
"developer_name": "RIGHT_BACK",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14668908835,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 96611,
"team_id": 3468,
"position_id": 27,
"formation_field": "4:2",
"type_id": 11,
"formation_position": 10,
"player_name": "Kylian Mbappé Lottin",
"jersey_number": 9,
"detailedposition": {
"id": 27,
"name": "Attacker",
"code": "attacker",
"developer_name": "ATTACKER",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14668923239,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 268,
"team_id": 3468,
"position_id": 26,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Luka Modrić",
"jersey_number": 10,
"detailedposition": null
},
{
"id": 14668908836,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 7346228,
"team_id": 3468,
"position_id": 26,
"formation_field": "3:4",
"type_id": 11,
"formation_position": 6,
"player_name": "Rodrygo Silva de Goes",
"jersey_number": 11,
"detailedposition": {
"id": 158,
"name": "Right Midfield",
"code": "right-midfield",
"developer_name": "RIGHT_MIDFIELD",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14668923240,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 205983,
"team_id": 3468,
"position_id": 24,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Andriy Lunin",
"jersey_number": 13,
"detailedposition": null
},
{
"id": 14668908837,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 5270371,
"team_id": 3468,
"position_id": 25,
"formation_field": "2:3",
"type_id": 11,
"formation_position": 3,
"player_name": "Aurélien Tchouaméni",
"jersey_number": 14,
"detailedposition": {
"id": 148,
"name": "Centre Back",
"code": "centre-back",
"developer_name": "CENTRE_BACK",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14668923241,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 37547467,
"team_id": 3468,
"position_id": 26,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Arda Guler",
"jersey_number": 15,
"detailedposition": null
},
{
"id": 14668923242,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 37647009,
"team_id": 3468,
"position_id": 27,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Endrick Felipe Moreira de Sousa",
"jersey_number": 16,
"detailedposition": null
},
{
"id": 14668923243,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 32536,
"team_id": 3468,
"position_id": 25,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Jesús Vallejo Lázaro",
"jersey_number": 18,
"detailedposition": null
},
{
"id": 14668908839,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 186734,
"team_id": 3468,
"position_id": 26,
"formation_field": "3:2",
"type_id": 11,
"formation_position": 8,
"player_name": "Daniel Ceballos Fernández",
"jersey_number": 19,
"detailedposition": {
"id": 153,
"name": "Central Midfield",
"code": "central-midfied",
"developer_name": "CENTRAL_MIDFIELD",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14668923244,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 537666,
"team_id": 3468,
"position_id": 25,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Francisco José García Torres",
"jersey_number": 20,
"detailedposition": null
},
{
"id": 14668923245,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 340342,
"team_id": 3468,
"position_id": 26,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Brahim Abdelkader Diaz",
"jersey_number": 21,
"detailedposition": null
},
{
"id": 14668922399,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 98903,
"team_id": 3468,
"position_id": 25,
"formation_field": "2:1",
"type_id": 11,
"formation_position": 5,
"player_name": "Ferland Mendy",
"jersey_number": 23,
"detailedposition": {
"id": 155,
"name": "Left Back",
"code": "left-back",
"developer_name": "LEFT_BACK",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14668923246,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 37593253,
"team_id": 3468,
"position_id": 27,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Gonzalo García Torres",
"jersey_number": 30,
"detailedposition": null
},
{
"id": 14668923247,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 37656089,
"team_id": 3468,
"position_id": 25,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Jacobo Ramón Naveros",
"jersey_number": 31,
"detailedposition": null
},
{
"id": 14668923248,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 37656203,
"team_id": 3468,
"position_id": 24,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Sergio Mestre Sánchez",
"jersey_number": 34,
"detailedposition": null
},
{
"id": 14668908841,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 37596373,
"team_id": 3468,
"position_id": 25,
"formation_field": "2:2",
"type_id": 11,
"formation_position": 4,
"player_name": "Raúl Asencio del Rosario",
"jersey_number": 35,
"detailedposition": {
"id": 148,
"name": "Centre Back",
"code": "centre-back",
"developer_name": "CENTRE_BACK",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14668923249,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 37656783,
"team_id": 3468,
"position_id": 26,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "José María Andrés Baixauli",
"jersey_number": 36,
"detailedposition": null
},
{
"id": 14668923250,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 37529826,
"team_id": 3468,
"position_id": 25,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Lorenzo Aguado Herrera",
"jersey_number": 39,
"detailedposition": null
}
]
},1.4 Combining the data
To properly display both team formations and player lineups, combine the formations and lineups includes in a single request:
https://api.sportmonks.com/v3/football/fixtures/19380879?api_token=YOURTOKEN&include=formations;lineups.detailedpositionResponse
{
"data": {
"id": 19380879,
"sport_id": 1,
"league_id": 2,
"season_id": 23619,
"stage_id": 77471316,
"group_id": null,
"aggregate_id": 58589,
"round_id": null,
"state_id": 5,
"venue_id": 151,
"name": "Manchester City vs Real Madrid",
"starting_at": "2025-02-11 20:00:00",
"result_info": "Real Madrid won after full-time.",
"leg": "1/2",
"details": null,
"length": 90,
"placeholder": false,
"has_odds": true,
"has_premium_odds": true,
"starting_at_timestamp": 1739304000,
"formations": [
{
"id": 8405326,
"fixture_id": 19380879,
"participant_id": 3468,
"formation": "4-4-2",
"location": "away"
},
{
"id": 8405325,
"fixture_id": 19380879,
"participant_id": 9,
"formation": "4-1-4-1",
"location": "home"
}
],
"lineups": [
{
"id": 14668918923,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 162536,
"team_id": 9,
"position_id": 25,
"formation_field": "2:2",
"type_id": 11,
"formation_position": 3,
"player_name": "Rúben Santos Gato Alves Dias",
"jersey_number": 3,
"detailedposition": {
"id": 148,
"name": "Centre Back",
"code": "centre-back",
"developer_name": "CENTRE_BACK",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14668923251,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 982,
"team_id": 9,
"position_id": 26,
"formation_field": "3:1",
"type_id": 11,
"formation_position": 6,
"player_name": "John Stones",
"jersey_number": 5,
"detailedposition": {
"id": 149,
"name": "Defensive Midfield",
"code": "defensive-midfied",
"developer_name": "DEFENSIVE_MIDFIELD",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14668923252,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 1869,
"team_id": 9,
"position_id": 25,
"formation_field": "2:3",
"type_id": 11,
"formation_position": 4,
"player_name": "Nathan Aké",
"jersey_number": 6,
"detailedposition": {
"id": 148,
"name": "Centre Back",
"code": "centre-back",
"developer_name": "CENTRE_BACK",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14668923253,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 294000,
"team_id": 9,
"position_id": 27,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Omar Marmoush",
"jersey_number": 7,
"detailedposition": null
},
{
"id": 14668908843,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 73147,
"team_id": 9,
"position_id": 26,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Mateo Kovačić",
"jersey_number": 8,
"detailedposition": null
},
{
"id": 14668908844,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 154421,
"team_id": 9,
"position_id": 27,
"formation_field": "5:1",
"type_id": 11,
"formation_position": 11,
"player_name": "Erling Håland",
"jersey_number": 9,
"detailedposition": {
"id": 27,
"name": "Attacker",
"code": "attacker",
"developer_name": "ATTACKER",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14668923254,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 1116,
"team_id": 9,
"position_id": 26,
"formation_field": "4:4",
"type_id": 11,
"formation_position": 10,
"player_name": "Jack Grealish",
"jersey_number": 10,
"detailedposition": {
"id": 157,
"name": "Left Midfield",
"code": "left-midfield",
"developer_name": "LEFT_MIDFIELD",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14668923255,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 23697990,
"team_id": 9,
"position_id": 27,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Jeremy Doku",
"jersey_number": 11,
"detailedposition": null
},
{
"id": 14668923256,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 23269737,
"team_id": 9,
"position_id": 26,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Nicolás González Iglesias",
"jersey_number": 14,
"detailedposition": null
},
{
"id": 14668908845,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 1371,
"team_id": 9,
"position_id": 26,
"formation_field": "4:2",
"type_id": 11,
"formation_position": 8,
"player_name": "Kevin De Bruyne",
"jersey_number": 17,
"detailedposition": {
"id": 153,
"name": "Central Midfield",
"code": "central-midfied",
"developer_name": "CENTRAL_MIDFIELD",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14668923257,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 34594,
"team_id": 9,
"position_id": 24,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Stefan Ortega Moreno",
"jersey_number": 18,
"detailedposition": null
},
{
"id": 14668923258,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 4842,
"team_id": 9,
"position_id": 26,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "İlkay Gündoğan",
"jersey_number": 19,
"detailedposition": null
},
{
"id": 14668908846,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 96353,
"team_id": 9,
"position_id": 26,
"formation_field": "4:3",
"type_id": 11,
"formation_position": 9,
"player_name": "Bernardo Mota Veiga de Carvalho e Silva",
"jersey_number": 20,
"detailedposition": {
"id": 153,
"name": "Central Midfield",
"code": "central-midfied",
"developer_name": "CENTRAL_MIDFIELD",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14668908847,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 24838191,
"team_id": 9,
"position_id": 25,
"formation_field": "2:4",
"type_id": 11,
"formation_position": 5,
"player_name": "Joško Gvardiol",
"jersey_number": 24,
"detailedposition": {
"id": 155,
"name": "Left Back",
"code": "left-back",
"developer_name": "LEFT_BACK",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14668908848,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 198062,
"team_id": 9,
"position_id": 25,
"formation_field": "2:1",
"type_id": 11,
"formation_position": 2,
"player_name": "Manuel Obafemi Akanji",
"jersey_number": 25,
"detailedposition": {
"id": 154,
"name": "Right Back",
"code": "right-back",
"developer_name": "RIGHT_BACK",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14668908849,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 37527169,
"team_id": 9,
"position_id": 26,
"formation_field": "4:1",
"type_id": 11,
"formation_position": 7,
"player_name": "Sávio Moreira de Oliveira",
"jersey_number": 26,
"detailedposition": {
"id": 158,
"name": "Right Midfield",
"code": "right-midfield",
"developer_name": "RIGHT_MIDFIELD",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14668908850,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 21781428,
"team_id": 9,
"position_id": 26,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Matheus Luiz Nunes",
"jersey_number": 27,
"detailedposition": null
},
{
"id": 14668918924,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 159142,
"team_id": 9,
"position_id": 24,
"formation_field": "1:1",
"type_id": 11,
"formation_position": 1,
"player_name": "Ederson Santana de Moraes",
"jersey_number": 31,
"detailedposition": {
"id": 24,
"name": "Goalkeeper",
"code": "goalkeeper",
"developer_name": "GOALKEEPER",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14668923259,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 37623459,
"team_id": 9,
"position_id": 25,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Abdukodir Khusanov",
"jersey_number": 45,
"detailedposition": null
},
{
"id": 14668908852,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 336133,
"team_id": 9,
"position_id": 26,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Philip Foden",
"jersey_number": 47,
"detailedposition": null
},
{
"id": 14668923260,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 37562487,
"team_id": 9,
"position_id": 26,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Nico O'Reilly",
"jersey_number": 75,
"detailedposition": null
},
{
"id": 14668923261,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 37459073,
"team_id": 9,
"position_id": 25,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Rico Lewis",
"jersey_number": 82,
"detailedposition": null
},
{
"id": 14668923262,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 28575676,
"team_id": 9,
"position_id": 26,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "James Mcatee",
"jersey_number": 87,
"detailedposition": null
},
{
"id": 14668908831,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 1314,
"team_id": 3468,
"position_id": 24,
"formation_field": "1:1",
"type_id": 11,
"formation_position": 1,
"player_name": "Thibaut Courtois",
"jersey_number": 1,
"detailedposition": {
"id": 24,
"name": "Goalkeeper",
"code": "goalkeeper",
"developer_name": "GOALKEEPER",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14668908832,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 37255840,
"team_id": 3468,
"position_id": 26,
"formation_field": "3:1",
"type_id": 11,
"formation_position": 9,
"player_name": "Jude Bellingham",
"jersey_number": 5,
"detailedposition": {
"id": 157,
"name": "Left Midfield",
"code": "left-midfield",
"developer_name": "LEFT_MIDFIELD",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14668916254,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 23688922,
"team_id": 3468,
"position_id": 26,
"formation_field": "3:3",
"type_id": 11,
"formation_position": 7,
"player_name": "Eduardo Camavinga",
"jersey_number": 6,
"detailedposition": {
"id": 153,
"name": "Central Midfield",
"code": "central-midfied",
"developer_name": "CENTRAL_MIDFIELD",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14668908833,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 600687,
"team_id": 3468,
"position_id": 27,
"formation_field": "4:1",
"type_id": 11,
"formation_position": 11,
"player_name": "Vinícius José Paixão de Oliveira Júnior",
"jersey_number": 7,
"detailedposition": {
"id": 27,
"name": "Attacker",
"code": "attacker",
"developer_name": "ATTACKER",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14668908834,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 260862,
"team_id": 3468,
"position_id": 25,
"formation_field": "2:4",
"type_id": 11,
"formation_position": 2,
"player_name": "Federico Santiago Valverde Dipetta",
"jersey_number": 8,
"detailedposition": {
"id": 154,
"name": "Right Back",
"code": "right-back",
"developer_name": "RIGHT_BACK",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14668908835,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 96611,
"team_id": 3468,
"position_id": 27,
"formation_field": "4:2",
"type_id": 11,
"formation_position": 10,
"player_name": "Kylian Mbappé Lottin",
"jersey_number": 9,
"detailedposition": {
"id": 27,
"name": "Attacker",
"code": "attacker",
"developer_name": "ATTACKER",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14668923239,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 268,
"team_id": 3468,
"position_id": 26,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Luka Modrić",
"jersey_number": 10,
"detailedposition": null
},
{
"id": 14668908836,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 7346228,
"team_id": 3468,
"position_id": 26,
"formation_field": "3:4",
"type_id": 11,
"formation_position": 6,
"player_name": "Rodrygo Silva de Goes",
"jersey_number": 11,
"detailedposition": {
"id": 158,
"name": "Right Midfield",
"code": "right-midfield",
"developer_name": "RIGHT_MIDFIELD",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14668923240,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 205983,
"team_id": 3468,
"position_id": 24,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Andriy Lunin",
"jersey_number": 13,
"detailedposition": null
},
{
"id": 14668908837,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 5270371,
"team_id": 3468,
"position_id": 25,
"formation_field": "2:3",
"type_id": 11,
"formation_position": 3,
"player_name": "Aurélien Tchouaméni",
"jersey_number": 14,
"detailedposition": {
"id": 148,
"name": "Centre Back",
"code": "centre-back",
"developer_name": "CENTRE_BACK",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14668923241,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 37547467,
"team_id": 3468,
"position_id": 26,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Arda Guler",
"jersey_number": 15,
"detailedposition": null
},
{
"id": 14668923242,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 37647009,
"team_id": 3468,
"position_id": 27,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Endrick Felipe Moreira de Sousa",
"jersey_number": 16,
"detailedposition": null
},
{
"id": 14668923243,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 32536,
"team_id": 3468,
"position_id": 25,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Jesús Vallejo Lázaro",
"jersey_number": 18,
"detailedposition": null
},
{
"id": 14668908839,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 186734,
"team_id": 3468,
"position_id": 26,
"formation_field": "3:2",
"type_id": 11,
"formation_position": 8,
"player_name": "Daniel Ceballos Fernández",
"jersey_number": 19,
"detailedposition": {
"id": 153,
"name": "Central Midfield",
"code": "central-midfied",
"developer_name": "CENTRAL_MIDFIELD",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14668923244,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 537666,
"team_id": 3468,
"position_id": 25,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Francisco José García Torres",
"jersey_number": 20,
"detailedposition": null
},
{
"id": 14668923245,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 340342,
"team_id": 3468,
"position_id": 26,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Brahim Abdelkader Diaz",
"jersey_number": 21,
"detailedposition": null
},
{
"id": 14668922399,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 98903,
"team_id": 3468,
"position_id": 25,
"formation_field": "2:1",
"type_id": 11,
"formation_position": 5,
"player_name": "Ferland Mendy",
"jersey_number": 23,
"detailedposition": {
"id": 155,
"name": "Left Back",
"code": "left-back",
"developer_name": "LEFT_BACK",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14668923246,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 37593253,
"team_id": 3468,
"position_id": 27,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Gonzalo García Torres",
"jersey_number": 30,
"detailedposition": null
},
{
"id": 14668923247,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 37656089,
"team_id": 3468,
"position_id": 25,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Jacobo Ramón Naveros",
"jersey_number": 31,
"detailedposition": null
},
{
"id": 14668923248,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 37656203,
"team_id": 3468,
"position_id": 24,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Sergio Mestre Sánchez",
"jersey_number": 34,
"detailedposition": null
},
{
"id": 14668908841,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 37596373,
"team_id": 3468,
"position_id": 25,
"formation_field": "2:2",
"type_id": 11,
"formation_position": 4,
"player_name": "Raúl Asencio del Rosario",
"jersey_number": 35,
"detailedposition": {
"id": 148,
"name": "Centre Back",
"code": "centre-back",
"developer_name": "CENTRE_BACK",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14668923249,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 37656783,
"team_id": 3468,
"position_id": 26,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "José María Andrés Baixauli",
"jersey_number": 36,
"detailedposition": null
},
{
"id": 14668923250,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 37529826,
"team_id": 3468,
"position_id": 25,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Lorenzo Aguado Herrera",
"jersey_number": 39,
"detailedposition": null
}
]
},1.5 Filtering on starting 11 and bench
As you’ve probably noticed in the API response, the lineups include returns all the players. If you’re interested in only the starting eleven or only the benched players, you can use a filter based on the lineup type id. For example, if you’re interested in only the benched players:
https://api.sportmonks.com/v3/football/fixtures/19380879?api_token=YOURTOKEN&include=lineups.detailedposition&filters=lineupTypes:12Response
{
"data": {
"id": 19380879,
"sport_id": 1,
"league_id": 2,
"season_id": 23619,
"stage_id": 77471316,
"group_id": null,
"aggregate_id": 58589,
"round_id": null,
"state_id": 5,
"venue_id": 151,
"name": "Manchester City vs Real Madrid",
"starting_at": "2025-02-11 20:00:00",
"result_info": "Real Madrid won after full-time.",
"leg": "1/2",
"details": null,
"length": 90,
"placeholder": false,
"has_odds": true,
"has_premium_odds": true,
"starting_at_timestamp": 1739304000,
"lineups": [
{
"id": 14668923253,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 294000,
"team_id": 9,
"position_id": 27,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Omar Marmoush",
"jersey_number": 7,
"detailedposition": null
},
{
"id": 14668908843,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 73147,
"team_id": 9,
"position_id": 26,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Mateo Kovačić",
"jersey_number": 8,
"detailedposition": null
},
{
"id": 14668923255,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 23697990,
"team_id": 9,
"position_id": 27,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Jeremy Doku",
"jersey_number": 11,
"detailedposition": null
},
{
"id": 14668923256,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 23269737,
"team_id": 9,
"position_id": 26,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Nicolás González Iglesias",
"jersey_number": 14,
"detailedposition": null
},
{
"id": 14668923257,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 34594,
"team_id": 9,
"position_id": 24,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Stefan Ortega Moreno",
"jersey_number": 18,
"detailedposition": null
},
{
"id": 14668923258,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 4842,
"team_id": 9,
"position_id": 26,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "İlkay Gündoğan",
"jersey_number": 19,
"detailedposition": null
},
{
"id": 14668908850,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 21781428,
"team_id": 9,
"position_id": 26,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Matheus Luiz Nunes",
"jersey_number": 27,
"detailedposition": null
},
{
"id": 14668923259,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 37623459,
"team_id": 9,
"position_id": 25,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Abdukodir Khusanov",
"jersey_number": 45,
"detailedposition": null
},
{
"id": 14668908852,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 336133,
"team_id": 9,
"position_id": 26,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Philip Foden",
"jersey_number": 47,
"detailedposition": null
},
{
"id": 14668923260,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 37562487,
"team_id": 9,
"position_id": 26,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Nico O'Reilly",
"jersey_number": 75,
"detailedposition": null
},
{
"id": 14668923261,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 37459073,
"team_id": 9,
"position_id": 25,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Rico Lewis",
"jersey_number": 82,
"detailedposition": null
},
{
"id": 14668923262,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 28575676,
"team_id": 9,
"position_id": 26,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "James Mcatee",
"jersey_number": 87,
"detailedposition": null
},
{
"id": 14668923239,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 268,
"team_id": 3468,
"position_id": 26,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Luka Modrić",
"jersey_number": 10,
"detailedposition": null
},
{
"id": 14668923240,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 205983,
"team_id": 3468,
"position_id": 24,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Andriy Lunin",
"jersey_number": 13,
"detailedposition": null
},
{
"id": 14668923241,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 37547467,
"team_id": 3468,
"position_id": 26,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Arda Guler",
"jersey_number": 15,
"detailedposition": null
},
{
"id": 14668923242,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 37647009,
"team_id": 3468,
"position_id": 27,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Endrick Felipe Moreira de Sousa",
"jersey_number": 16,
"detailedposition": null
},
{
"id": 14668923243,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 32536,
"team_id": 3468,
"position_id": 25,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Jesús Vallejo Lázaro",
"jersey_number": 18,
"detailedposition": null
},
{
"id": 14668923244,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 537666,
"team_id": 3468,
"position_id": 25,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Francisco José García Torres",
"jersey_number": 20,
"detailedposition": null
},
{
"id": 14668923245,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 340342,
"team_id": 3468,
"position_id": 26,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Brahim Abdelkader Diaz",
"jersey_number": 21,
"detailedposition": null
},
{
"id": 14668923246,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 37593253,
"team_id": 3468,
"position_id": 27,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Gonzalo García Torres",
"jersey_number": 30,
"detailedposition": null
},
{
"id": 14668923247,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 37656089,
"team_id": 3468,
"position_id": 25,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Jacobo Ramón Naveros",
"jersey_number": 31,
"detailedposition": null
},
{
"id": 14668923248,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 37656203,
"team_id": 3468,
"position_id": 24,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Sergio Mestre Sánchez",
"jersey_number": 34,
"detailedposition": null
},
{
"id": 14668923249,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 37656783,
"team_id": 3468,
"position_id": 26,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "José María Andrés Baixauli",
"jersey_number": 36,
"detailedposition": null
},
{
"id": 14668923250,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 37529826,
"team_id": 3468,
"position_id": 25,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Lorenzo Aguado Herrera",
"jersey_number": 39,
"detailedposition": null
}
]
},Or only the starting eleven:
https://api.sportmonks.com/v3/football/fixtures/19380879?api_token=YOURTOKEN&include=lineups.detailedposition&filters=lineupTypes:11Response
{
"data": {
"id": 19380879,
"sport_id": 1,
"league_id": 2,
"season_id": 23619,
"stage_id": 77471316,
"group_id": null,
"aggregate_id": 58589,
"round_id": null,
"state_id": 5,
"venue_id": 151,
"name": "Manchester City vs Real Madrid",
"starting_at": "2025-02-11 20:00:00",
"result_info": "Real Madrid won after full-time.",
"leg": "1/2",
"details": null,
"length": 90,
"placeholder": false,
"has_odds": true,
"has_premium_odds": true,
"starting_at_timestamp": 1739304000,
"lineups": [
{
"id": 14668918923,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 162536,
"team_id": 9,
"position_id": 25,
"formation_field": "2:2",
"type_id": 11,
"formation_position": 3,
"player_name": "Rúben Santos Gato Alves Dias",
"jersey_number": 3,
"detailedposition": {
"id": 148,
"name": "Centre Back",
"code": "centre-back",
"developer_name": "CENTRE_BACK",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14668923251,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 982,
"team_id": 9,
"position_id": 26,
"formation_field": "3:1",
"type_id": 11,
"formation_position": 6,
"player_name": "John Stones",
"jersey_number": 5,
"detailedposition": {
"id": 149,
"name": "Defensive Midfield",
"code": "defensive-midfied",
"developer_name": "DEFENSIVE_MIDFIELD",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14668923252,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 1869,
"team_id": 9,
"position_id": 25,
"formation_field": "2:3",
"type_id": 11,
"formation_position": 4,
"player_name": "Nathan Aké",
"jersey_number": 6,
"detailedposition": {
"id": 148,
"name": "Centre Back",
"code": "centre-back",
"developer_name": "CENTRE_BACK",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14668908844,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 154421,
"team_id": 9,
"position_id": 27,
"formation_field": "5:1",
"type_id": 11,
"formation_position": 11,
"player_name": "Erling Håland",
"jersey_number": 9,
"detailedposition": {
"id": 27,
"name": "Attacker",
"code": "attacker",
"developer_name": "ATTACKER",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14668923254,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 1116,
"team_id": 9,
"position_id": 26,
"formation_field": "4:4",
"type_id": 11,
"formation_position": 10,
"player_name": "Jack Grealish",
"jersey_number": 10,
"detailedposition": {
"id": 157,
"name": "Left Midfield",
"code": "left-midfield",
"developer_name": "LEFT_MIDFIELD",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14668908845,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 1371,
"team_id": 9,
"position_id": 26,
"formation_field": "4:2",
"type_id": 11,
"formation_position": 8,
"player_name": "Kevin De Bruyne",
"jersey_number": 17,
"detailedposition": {
"id": 153,
"name": "Central Midfield",
"code": "central-midfied",
"developer_name": "CENTRAL_MIDFIELD",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14668908846,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 96353,
"team_id": 9,
"position_id": 26,
"formation_field": "4:3",
"type_id": 11,
"formation_position": 9,
"player_name": "Bernardo Mota Veiga de Carvalho e Silva",
"jersey_number": 20,
"detailedposition": {
"id": 153,
"name": "Central Midfield",
"code": "central-midfied",
"developer_name": "CENTRAL_MIDFIELD",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14668908847,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 24838191,
"team_id": 9,
"position_id": 25,
"formation_field": "2:4",
"type_id": 11,
"formation_position": 5,
"player_name": "Joško Gvardiol",
"jersey_number": 24,
"detailedposition": {
"id": 155,
"name": "Left Back",
"code": "left-back",
"developer_name": "LEFT_BACK",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14668908848,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 198062,
"team_id": 9,
"position_id": 25,
"formation_field": "2:1",
"type_id": 11,
"formation_position": 2,
"player_name": "Manuel Obafemi Akanji",
"jersey_number": 25,
"detailedposition": {
"id": 154,
"name": "Right Back",
"code": "right-back",
"developer_name": "RIGHT_BACK",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14668908849,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 37527169,
"team_id": 9,
"position_id": 26,
"formation_field": "4:1",
"type_id": 11,
"formation_position": 7,
"player_name": "Sávio Moreira de Oliveira",
"jersey_number": 26,
"detailedposition": {
"id": 158,
"name": "Right Midfield",
"code": "right-midfield",
"developer_name": "RIGHT_MIDFIELD",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14668918924,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 159142,
"team_id": 9,
"position_id": 24,
"formation_field": "1:1",
"type_id": 11,
"formation_position": 1,
"player_name": "Ederson Santana de Moraes",
"jersey_number": 31,
"detailedposition": {
"id": 24,
"name": "Goalkeeper",
"code": "goalkeeper",
"developer_name": "GOALKEEPER",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14668908831,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 1314,
"team_id": 3468,
"position_id": 24,
"formation_field": "1:1",
"type_id": 11,
"formation_position": 1,
"player_name": "Thibaut Courtois",
"jersey_number": 1,
"detailedposition": {
"id": 24,
"name": "Goalkeeper",
"code": "goalkeeper",
"developer_name": "GOALKEEPER",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14668908832,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 37255840,
"team_id": 3468,
"position_id": 26,
"formation_field": "3:1",
"type_id": 11,
"formation_position": 9,
"player_name": "Jude Bellingham",
"jersey_number": 5,
"detailedposition": {
"id": 157,
"name": "Left Midfield",
"code": "left-midfield",
"developer_name": "LEFT_MIDFIELD",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14668916254,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 23688922,
"team_id": 3468,
"position_id": 26,
"formation_field": "3:3",
"type_id": 11,
"formation_position": 7,
"player_name": "Eduardo Camavinga",
"jersey_number": 6,
"detailedposition": {
"id": 153,
"name": "Central Midfield",
"code": "central-midfied",
"developer_name": "CENTRAL_MIDFIELD",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14668908833,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 600687,
"team_id": 3468,
"position_id": 27,
"formation_field": "4:1",
"type_id": 11,
"formation_position": 11,
"player_name": "Vinícius José Paixão de Oliveira Júnior",
"jersey_number": 7,
"detailedposition": {
"id": 27,
"name": "Attacker",
"code": "attacker",
"developer_name": "ATTACKER",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14668908834,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 260862,
"team_id": 3468,
"position_id": 25,
"formation_field": "2:4",
"type_id": 11,
"formation_position": 2,
"player_name": "Federico Santiago Valverde Dipetta",
"jersey_number": 8,
"detailedposition": {
"id": 154,
"name": "Right Back",
"code": "right-back",
"developer_name": "RIGHT_BACK",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14668908835,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 96611,
"team_id": 3468,
"position_id": 27,
"formation_field": "4:2",
"type_id": 11,
"formation_position": 10,
"player_name": "Kylian Mbappé Lottin",
"jersey_number": 9,
"detailedposition": {
"id": 27,
"name": "Attacker",
"code": "attacker",
"developer_name": "ATTACKER",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14668908836,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 7346228,
"team_id": 3468,
"position_id": 26,
"formation_field": "3:4",
"type_id": 11,
"formation_position": 6,
"player_name": "Rodrygo Silva de Goes",
"jersey_number": 11,
"detailedposition": {
"id": 158,
"name": "Right Midfield",
"code": "right-midfield",
"developer_name": "RIGHT_MIDFIELD",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14668908837,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 5270371,
"team_id": 3468,
"position_id": 25,
"formation_field": "2:3",
"type_id": 11,
"formation_position": 3,
"player_name": "Aurélien Tchouaméni",
"jersey_number": 14,
"detailedposition": {
"id": 148,
"name": "Centre Back",
"code": "centre-back",
"developer_name": "CENTRE_BACK",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14668908839,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 186734,
"team_id": 3468,
"position_id": 26,
"formation_field": "3:2",
"type_id": 11,
"formation_position": 8,
"player_name": "Daniel Ceballos Fernández",
"jersey_number": 19,
"detailedposition": {
"id": 153,
"name": "Central Midfield",
"code": "central-midfied",
"developer_name": "CENTRAL_MIDFIELD",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14668922399,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 98903,
"team_id": 3468,
"position_id": 25,
"formation_field": "2:1",
"type_id": 11,
"formation_position": 5,
"player_name": "Ferland Mendy",
"jersey_number": 23,
"detailedposition": {
"id": 155,
"name": "Left Back",
"code": "left-back",
"developer_name": "LEFT_BACK",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14668908841,
"sport_id": 1,
"fixture_id": 19380879,
"player_id": 37596373,
"team_id": 3468,
"position_id": 25,
"formation_field": "2:2",
"type_id": 11,
"formation_position": 4,
"player_name": "Raúl Asencio del Rosario",
"jersey_number": 35,
"detailedposition": {
"id": 148,
"name": "Centre Back",
"code": "centre-back",
"developer_name": "CENTRE_BACK",
"model_type": "position",
"stat_group": null
}
}
]
},1.6 Sidelined players
A team may have players who are unavailable due to injuries or suspensions. This information is crucial for determining why certain players are missing from the lineup.
To retrieve sidelined players, use the sidelined.player include:
https://api.sportmonks.com/v3/football/fixtures/19134562?api_token=YOURTOKEN&include=sidelined.sideline;sidelined.playerResponse
{
"data": {
"id": 19134562,
"sport_id": 1,
"league_id": 8,
"season_id": 23614,
"stage_id": 77471288,
"group_id": null,
"aggregate_id": null,
"round_id": 339255,
"state_id": 5,
"venue_id": 206,
"name": "Manchester United vs Southampton",
"starting_at": "2025-01-16 20:00:00",
"result_info": "Manchester United won after full-time.",
"leg": "1\/1",
"details": null,
"length": 90,
"placeholder": false,
"has_odds": true,
"has_premium_odds": true,
"starting_at_timestamp": 1737057600,
"sidelined": [
{
"id": 468798,
"fixture_id": 19134562,
"sideline_id": 112256,
"participant_id": 65,
"player_id": 3596,
"type_id": 1619,
"player": {
"id": 3596,
"sport_id": 1,
"country_id": 462,
"nationality_id": 1161,
"city_id": null,
"position_id": 27,
"detailed_position_id": 151,
"type_id": 26,
"common_name": "C. Adams",
"firstname": "Che",
"lastname": "Adams",
"name": "Che Adams",
"display_name": "Che Adams",
"image_path": "https:\/\/cdn.sportmonks.com\/images\/soccer\/players\/12\/3596.png",
"height": 179,
"weight": null,
"date_of_birth": "1996-07-13",
"gender": "male"
},
"sideline": {
"id": 112256,
"player_id": 3596,
"type_id": 1619,
"category": "doubtful",
"team_id": 65,
"season_id": null,
"start_date": "2023-05-28",
"end_date": null,
"games_missed": null,
"completed": false
}
},
{
"id": 468799,
"fixture_id": 19134562,
"sideline_id": 112253,
"participant_id": 65,
"player_id": 11347016,
"type_id": 1618,
"player": {
"id": 11347016,
"sport_id": 1,
"country_id": 468,
"nationality_id": 468,
"city_id": null,
"position_id": 25,
"detailed_position_id": 148,
"type_id": 25,
"common_name": "M. Karim",
"firstname": "Mohamed Salisu Abdul",
"lastname": "Karim",
"name": "Mohamed Salisu Abdul Karim",
"display_name": "Mohammed Salisu",
"image_path": "https:\/\/cdn.sportmonks.com\/images\/soccer\/players\/8\/11347016.png",
"height": 188,
"weight": 82,
"date_of_birth": "1999-04-17",
"gender": "male"
},
"sideline": {
"id": 112253,
"player_id": 11347016,
"type_id": 1618,
"category": "out",
"team_id": 65,
"season_id": null,
"start_date": "2023-05-27",
"end_date": null,
"games_missed": null,
"completed": false
}
},
{
"id": 468800,
"fixture_id": 19134562,
"sideline_id": 112255,
"participant_id": 65,
"player_id": 337432,
"type_id": 1618,
"player": {
"id": 337432,
"sport_id": 1,
"country_id": 17,
"nationality_id": 17,
"city_id": null,
"position_id": 25,
"detailed_position_id": 155,
"type_id": 25,
"common_name": "R. Perraud",
"firstname": "Romain",
"lastname": "Perraud",
"name": "Romain Perraud",
"display_name": "Romain Perraud",
"image_path": "https:\/\/cdn.sportmonks.com\/images\/soccer\/players\/24\/337432.png",
"height": 173,
"weight": 68,
"date_of_birth": "1997-09-22",
"gender": "male"
},
"sideline": {
"id": 112255,
"player_id": 337432,
"type_id": 1618,
"category": "out",
"team_id": 65,
"season_id": null,
"start_date": "2023-05-27",
"end_date": null,
"games_missed": null,
"completed": false
}
},
{
"id": 468801,
"fixture_id": 19134562,
"sideline_id": 112252,
"participant_id": 65,
"player_id": 37316841,
"type_id": 587,
"player": {
"id": 37316841,
"sport_id": 1,
"country_id": 462,
"nationality_id": 462,
"city_id": null,
"position_id": 27,
"detailed_position_id": 152,
"type_id": 27,
"common_name": "S. Edozie",
"firstname": "Samuel",
"lastname": "Edozie",
"name": "Samuel Edozie",
"display_name": "Samuel Edozie",
"image_path": "https:\/\/cdn.sportmonks.com\/images\/soccer\/players\/9\/37316841.png",
"height": 181,
"weight": null,
"date_of_birth": "2003-01-28",
"gender": "male"
},
"sideline": {
"id": 112252,
"player_id": 37316841,
"type_id": 587,
"category": "unknown-injury",
"team_id": 65,
"season_id": null,
"start_date": "2023-05-27",
"end_date": null,
"games_missed": null,
"completed": false
}
},
{
"id": 468802,
"fixture_id": 19134562,
"sideline_id": 112254,
"participant_id": 65,
"player_id": 37537876,
"type_id": 1618,
"player": {
"id": 37537876,
"sport_id": 1,
"country_id": 32,
"nationality_id": 32,
"city_id": null,
"position_id": 25,
"detailed_position_id": 155,
"type_id": 25,
"common_name": "J. Larios L\u00f3pez",
"firstname": "Juan",
"lastname": "Larios L\u00f3pez",
"name": "Juan Larios L\u00f3pez",
"display_name": "Juan Larios",
"image_path": "https:\/\/cdn.sportmonks.com\/images\/soccer\/players\/20\/37537876.png",
"height": 170,
"weight": null,
"date_of_birth": "2004-01-12",
"gender": "male"
},
"sideline": {
"id": 112254,
"player_id": 37537876,
"type_id": 1618,
"category": "out",
"team_id": 65,
"season_id": null,
"start_date": "2023-05-27",
"end_date": null,
"games_missed": null,
"completed": false
}
},
{
"id": 468791,
"fixture_id": 19134562,
"sideline_id": 112277,
"participant_id": 14,
"player_id": 1454,
"type_id": 1618,
"player": {
"id": 1454,
"sport_id": 1,
"country_id": 462,
"nationality_id": 462,
"city_id": null,
"position_id": 24,
"detailed_position_id": 24,
"type_id": 24,
"common_name": "T. Heaton",
"firstname": "Tom",
"lastname": "Heaton",
"name": "Tom Heaton",
"display_name": "Tom Heaton",
"image_path": "https:\/\/cdn.sportmonks.com\/images\/soccer\/players\/14\/1454.png",
"height": 188,
"weight": 85,
"date_of_birth": "1986-04-15",
"gender": "male"
},
"sideline": {
"id": 112277,
"player_id": 1454,
"type_id": 1618,
"category": "out",
"team_id": 14,
"season_id": null,
"start_date": "2023-08-21",
"end_date": null,
"games_missed": null,
"completed": false
}
},
{
"id": 468792,
"fixture_id": 19134562,
"sideline_id": 692738,
"participant_id": 14,
"player_id": 164061,
"type_id": 1610,
"player": {
"id": 164061,
"sport_id": 1,
"country_id": 20,
"nationality_id": 20,
"city_id": null,
"position_id": 25,
"detailed_position_id": 154,
"type_id": 25,
"common_name": "J. Dalot Teixeira",
"firstname": "Jos\u00e9 Diogo",
"lastname": "Dalot Teixeira",
"name": "Jos\u00e9 Diogo Dalot Teixeira",
"display_name": "Diogo Dalot",
"image_path": "https:\/\/cdn.sportmonks.com\/images\/soccer\/players\/29\/164061.png",
"height": 183,
"weight": null,
"date_of_birth": "1999-03-18",
"gender": "male"
},
"sideline": {
"id": 692738,
"player_id": 164061,
"type_id": 1610,
"category": "suspended",
"team_id": 14,
"season_id": null,
"start_date": "2025-01-13",
"end_date": "2025-01-16",
"games_missed": 0,
"completed": true
}
}
]
}
}Of course, you can combine all the information into one request:
https://api.sportmonks.com/v3/football/fixtures/19134562?api_token=YOURTOKEN&include=lineups.detailedposition;sidelined.sideline;sidelined.playerResponse
{
"data": {
"id": 19134562,
"sport_id": 1,
"league_id": 8,
"season_id": 23614,
"stage_id": 77471288,
"group_id": null,
"aggregate_id": null,
"round_id": 339255,
"state_id": 5,
"venue_id": 206,
"name": "Manchester United vs Southampton",
"starting_at": "2025-01-16 20:00:00",
"result_info": "Manchester United won after full-time.",
"leg": "1\/1",
"details": null,
"length": 90,
"placeholder": false,
"has_odds": true,
"has_premium_odds": true,
"starting_at_timestamp": 1737057600,
"lineups": [
{
"id": 14657828393,
"sport_id": 1,
"fixture_id": 19134562,
"player_id": 438751,
"team_id": 14,
"position_id": 24,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Altay Bay\u0131nd\u0131r",
"jersey_number": 1,
"detailedposition": null
},
{
"id": 14655546210,
"sport_id": 1,
"fixture_id": 19134562,
"player_id": 28716,
"team_id": 14,
"position_id": 26,
"formation_field": "3:4",
"type_id": 11,
"formation_position": 8,
"player_name": "Noussair Mazraoui",
"jersey_number": 3,
"detailedposition": {
"id": 157,
"name": "Left Midfield",
"code": "left-midfield",
"developer_name": "LEFT_MIDFIELD",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14655546211,
"sport_id": 1,
"fixture_id": 19134562,
"player_id": 26768,
"team_id": 14,
"position_id": 25,
"formation_field": "2:2",
"type_id": 11,
"formation_position": 3,
"player_name": "Matthijs de Ligt",
"jersey_number": 4,
"detailedposition": {
"id": 148,
"name": "Centre Back",
"code": "centre-back",
"developer_name": "CENTRE_BACK",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14657828394,
"sport_id": 1,
"fixture_id": 19134562,
"player_id": 2884,
"team_id": 14,
"position_id": 25,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Harry Maguire",
"jersey_number": 5,
"detailedposition": null
},
{
"id": 14655546212,
"sport_id": 1,
"fixture_id": 19134562,
"player_id": 2206665,
"team_id": 14,
"position_id": 25,
"formation_field": "2:3",
"type_id": 11,
"formation_position": 4,
"player_name": "Lisandro Mart\u00ednez\u00a0",
"jersey_number": 6,
"detailedposition": {
"id": 148,
"name": "Centre Back",
"code": "centre-back",
"developer_name": "CENTRE_BACK",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14655546213,
"sport_id": 1,
"fixture_id": 19134562,
"player_id": 129602,
"team_id": 14,
"position_id": 27,
"formation_field": "4:1",
"type_id": 11,
"formation_position": 9,
"player_name": "Bruno Fernandes\u00a0",
"jersey_number": 8,
"detailedposition": {
"id": 150,
"name": "Attacking Midfield",
"code": "attacking-midfied",
"developer_name": "ATTACKING_MIDFIELD",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14657805561,
"sport_id": 1,
"fixture_id": 19134562,
"player_id": 37325012,
"team_id": 14,
"position_id": 27,
"formation_field": "5:1",
"type_id": 11,
"formation_position": 11,
"player_name": "Rasmus H\u00f8jlund",
"jersey_number": 9,
"detailedposition": {
"id": 27,
"name": "Attacker",
"code": "attacker",
"developer_name": "ATTACKER",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14657828395,
"sport_id": 1,
"fixture_id": 19134562,
"player_id": 9605680,
"team_id": 14,
"position_id": 27,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Joshua Zirkzee",
"jersey_number": 11,
"detailedposition": null
},
{
"id": 14657828396,
"sport_id": 1,
"fixture_id": 19134562,
"player_id": 2158417,
"team_id": 14,
"position_id": 25,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Tyrell Malacia",
"jersey_number": 12,
"detailedposition": null
},
{
"id": 14657828397,
"sport_id": 1,
"fixture_id": 19134562,
"player_id": 992,
"team_id": 14,
"position_id": 26,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Christian Eriksen",
"jersey_number": 14,
"detailedposition": null
},
{
"id": 14655546216,
"sport_id": 1,
"fixture_id": 19134562,
"player_id": 37600357,
"team_id": 14,
"position_id": 25,
"formation_field": "2:1",
"type_id": 11,
"formation_position": 2,
"player_name": "Leny Yoro",
"jersey_number": 15,
"detailedposition": {
"id": 148,
"name": "Centre Back",
"code": "centre-back",
"developer_name": "CENTRE_BACK",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14655546217,
"sport_id": 1,
"fixture_id": 19134562,
"player_id": 37317015,
"team_id": 14,
"position_id": 26,
"formation_field": "3:1",
"type_id": 11,
"formation_position": 5,
"player_name": "Amad Diallo",
"jersey_number": 16,
"detailedposition": {
"id": 158,
"name": "Right Midfield",
"code": "right-midfield",
"developer_name": "RIGHT_MIDFIELD",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14657805534,
"sport_id": 1,
"fixture_id": 19134562,
"player_id": 37316549,
"team_id": 14,
"position_id": 27,
"formation_field": "4:2",
"type_id": 11,
"formation_position": 10,
"player_name": "Alejandro Garnacho",
"jersey_number": 17,
"detailedposition": {
"id": 150,
"name": "Attacking Midfield",
"code": "attacking-midfied",
"developer_name": "ATTACKING_MIDFIELD",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14657828398,
"sport_id": 1,
"fixture_id": 19134562,
"player_id": 159700,
"team_id": 14,
"position_id": 26,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Casemiro",
"jersey_number": 18,
"detailedposition": null
},
{
"id": 14657828399,
"sport_id": 1,
"fixture_id": 19134562,
"player_id": 12393293,
"team_id": 14,
"position_id": 27,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Antony",
"jersey_number": 21,
"detailedposition": null
},
{
"id": 14655546218,
"sport_id": 1,
"fixture_id": 19134562,
"player_id": 26393,
"team_id": 14,
"position_id": 24,
"formation_field": "1:1",
"type_id": 11,
"formation_position": 1,
"player_name": "Andr\u00e9 Onana",
"jersey_number": 24,
"detailedposition": {
"id": 24,
"name": "Goalkeeper",
"code": "goalkeeper",
"developer_name": "GOALKEEPER",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14657805532,
"sport_id": 1,
"fixture_id": 19134562,
"player_id": 893705,
"team_id": 14,
"position_id": 26,
"formation_field": "3:2",
"type_id": 11,
"formation_position": 6,
"player_name": "Manuel Ugarte",
"jersey_number": 25,
"detailedposition": {
"id": 153,
"name": "Central Midfield",
"code": "central-midfied",
"developer_name": "CENTRAL_MIDFIELD",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14657805557,
"sport_id": 1,
"fixture_id": 19134562,
"player_id": 37540234,
"team_id": 14,
"position_id": 26,
"formation_field": "3:3",
"type_id": 11,
"formation_position": 7,
"player_name": "Kobbie Mainoo",
"jersey_number": 37,
"detailedposition": {
"id": 153,
"name": "Central Midfield",
"code": "central-midfied",
"developer_name": "CENTRAL_MIDFIELD",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14657828400,
"sport_id": 1,
"fixture_id": 19134562,
"player_id": 30851415,
"team_id": 14,
"position_id": 26,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Toby Collyer",
"jersey_number": 43,
"detailedposition": null
},
{
"id": 14657828401,
"sport_id": 1,
"fixture_id": 19134562,
"player_id": 37718822,
"team_id": 14,
"position_id": 25,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "G. Kukonki",
"jersey_number": 87,
"detailedposition": null
},
{
"id": 14657828384,
"sport_id": 1,
"fixture_id": 19134562,
"player_id": 1131,
"team_id": 65,
"position_id": 24,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Alex McCarthy",
"jersey_number": 1,
"detailedposition": null
},
{
"id": 14655546199,
"sport_id": 1,
"fixture_id": 19134562,
"player_id": 4659,
"team_id": 65,
"position_id": 26,
"formation_field": "3:1",
"type_id": 11,
"formation_position": 8,
"player_name": "Kyle Walker-Peters",
"jersey_number": 2,
"detailedposition": {
"id": 157,
"name": "Left Midfield",
"code": "left-midfield",
"developer_name": "LEFT_MIDFIELD",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14657828385,
"sport_id": 1,
"fixture_id": 19134562,
"player_id": 7640,
"team_id": 65,
"position_id": 25,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Ryan Manning",
"jersey_number": 3,
"detailedposition": null
},
{
"id": 14657828386,
"sport_id": 1,
"fixture_id": 19134562,
"player_id": 518749,
"team_id": 65,
"position_id": 26,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Flynn Downes",
"jersey_number": 4,
"detailedposition": null
},
{
"id": 14655546201,
"sport_id": 1,
"fixture_id": 19134562,
"player_id": 23278675,
"team_id": 65,
"position_id": 25,
"formation_field": "2:1",
"type_id": 11,
"formation_position": 4,
"player_name": "Taylor Harwood-Bellis",
"jersey_number": 6,
"detailedposition": {
"id": 148,
"name": "Centre Back",
"code": "centre-back",
"developer_name": "CENTRE_BACK",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14655546202,
"sport_id": 1,
"fixture_id": 19134562,
"player_id": 9826,
"team_id": 65,
"position_id": 26,
"formation_field": "3:2",
"type_id": 11,
"formation_position": 7,
"player_name": "Joe Aribo",
"jersey_number": 7,
"detailedposition": {
"id": 153,
"name": "Central Midfield",
"code": "central-midfied",
"developer_name": "CENTRAL_MIDFIELD",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14657828387,
"sport_id": 1,
"fixture_id": 19134562,
"player_id": 581052,
"team_id": 65,
"position_id": 26,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Will Smallbone\u00a0",
"jersey_number": 8,
"detailedposition": null
},
{
"id": 14657828388,
"sport_id": 1,
"fixture_id": 19134562,
"player_id": 2951,
"team_id": 65,
"position_id": 27,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Adam Armstrong",
"jersey_number": 9,
"detailedposition": null
},
{
"id": 14657828389,
"sport_id": 1,
"fixture_id": 19134562,
"player_id": 1149,
"team_id": 65,
"position_id": 26,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Adam Lallana",
"jersey_number": 10,
"detailedposition": null
},
{
"id": 14655546203,
"sport_id": 1,
"fixture_id": 19134562,
"player_id": 6513,
"team_id": 65,
"position_id": 25,
"formation_field": "2:3",
"type_id": 11,
"formation_position": 2,
"player_name": "James Bree",
"jersey_number": 14,
"detailedposition": {
"id": 148,
"name": "Centre Back",
"code": "centre-back",
"developer_name": "CENTRE_BACK",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14657828390,
"sport_id": 1,
"fixture_id": 19134562,
"player_id": 3188067,
"team_id": 65,
"position_id": 25,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Nathan Wood",
"jersey_number": 15,
"detailedposition": null
},
{
"id": 14657805540,
"sport_id": 1,
"fixture_id": 19134562,
"player_id": 5666480,
"team_id": 65,
"position_id": 26,
"formation_field": "3:4",
"type_id": 11,
"formation_position": 5,
"player_name": "Yukinari Sugawara",
"jersey_number": 16,
"detailedposition": {
"id": 158,
"name": "Right Midfield",
"code": "right-midfield",
"developer_name": "RIGHT_MIDFIELD",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14655546204,
"sport_id": 1,
"fixture_id": 19134562,
"player_id": 37593153,
"team_id": 65,
"position_id": 27,
"formation_field": "4:1",
"type_id": 11,
"formation_position": 9,
"player_name": "Mateus Fernandes",
"jersey_number": 18,
"detailedposition": {
"id": 150,
"name": "Attacking Midfield",
"code": "attacking-midfied",
"developer_name": "ATTACKING_MIDFIELD",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14657828391,
"sport_id": 1,
"fixture_id": 19134562,
"player_id": 28912777,
"team_id": 65,
"position_id": 27,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Cameron Archer",
"jersey_number": 19,
"detailedposition": null
},
{
"id": 14657787438,
"sport_id": 1,
"fixture_id": 19134562,
"player_id": 37438667,
"team_id": 65,
"position_id": 27,
"formation_field": "5:1",
"type_id": 11,
"formation_position": 11,
"player_name": "Kamaldeen Sulemana",
"jersey_number": 20,
"detailedposition": {
"id": 27,
"name": "Attacker",
"code": "attacker",
"developer_name": "ATTACKER",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14655546205,
"sport_id": 1,
"fixture_id": 19134562,
"player_id": 37423141,
"team_id": 65,
"position_id": 26,
"formation_field": "3:3",
"type_id": 11,
"formation_position": 6,
"player_name": "Lesley Ugochukwu",
"jersey_number": 26,
"detailedposition": {
"id": 153,
"name": "Central Midfield",
"code": "central-midfied",
"developer_name": "CENTRAL_MIDFIELD",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14655546206,
"sport_id": 1,
"fixture_id": 19134562,
"player_id": 9438,
"team_id": 65,
"position_id": 24,
"formation_field": "1:1",
"type_id": 11,
"formation_position": 1,
"player_name": "Aaron Ramsdale",
"jersey_number": 30,
"detailedposition": {
"id": 24,
"name": "Goalkeeper",
"code": "goalkeeper",
"developer_name": "GOALKEEPER",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14657828392,
"sport_id": 1,
"fixture_id": 19134562,
"player_id": 84143,
"team_id": 65,
"position_id": 27,
"formation_field": null,
"type_id": 12,
"formation_position": null,
"player_name": "Paul Onuachu",
"jersey_number": 32,
"detailedposition": null
},
{
"id": 14655546208,
"sport_id": 1,
"fixture_id": 19134562,
"player_id": 37561126,
"team_id": 65,
"position_id": 27,
"formation_field": "5:2",
"type_id": 11,
"formation_position": 10,
"player_name": "Tyler Dibling",
"jersey_number": 33,
"detailedposition": {
"id": 27,
"name": "Attacker",
"code": "attacker",
"developer_name": "ATTACKER",
"model_type": "position",
"stat_group": null
}
},
{
"id": 14655546209,
"sport_id": 1,
"fixture_id": 19134562,
"player_id": 155138,
"team_id": 65,
"position_id": 25,
"formation_field": "2:2",
"type_id": 11,
"formation_position": 3,
"player_name": "Jan Bednarek",
"jersey_number": 35,
"detailedposition": {
"id": 148,
"name": "Centre Back",
"code": "centre-back",
"developer_name": "CENTRE_BACK",
"model_type": "position",
"stat_group": null
}
}
],
"sidelined": [
{
"id": 468798,
"fixture_id": 19134562,
"sideline_id": 112256,
"participant_id": 65,
"player_id": 3596,
"type_id": 1619,
"sideline": {
"id": 112256,
"player_id": 3596,
"type_id": 1619,
"category": "doubtful",
"team_id": 65,
"season_id": null,
"start_date": "2023-05-28",
"end_date": null,
"games_missed": null,
"completed": false
},
"player": {
"id": 3596,
"sport_id": 1,
"country_id": 462,
"nationality_id": 1161,
"city_id": null,
"position_id": 27,
"detailed_position_id": 151,
"type_id": 26,
"common_name": "C. Adams",
"firstname": "Che",
"lastname": "Adams",
"name": "Che Adams",
"display_name": "Che Adams",
"image_path": "https:\/\/cdn.sportmonks.com\/images\/soccer\/players\/12\/3596.png",
"height": 179,
"weight": null,
"date_of_birth": "1996-07-13",
"gender": "male"
}
},
{
"id": 468799,
"fixture_id": 19134562,
"sideline_id": 112253,
"participant_id": 65,
"player_id": 11347016,
"type_id": 1618,
"sideline": {
"id": 112253,
"player_id": 11347016,
"type_id": 1618,
"category": "out",
"team_id": 65,
"season_id": null,
"start_date": "2023-05-27",
"end_date": null,
"games_missed": null,
"completed": false
},
"player": {
"id": 11347016,
"sport_id": 1,
"country_id": 468,
"nationality_id": 468,
"city_id": null,
"position_id": 25,
"detailed_position_id": 148,
"type_id": 25,
"common_name": "M. Karim",
"firstname": "Mohamed Salisu Abdul",
"lastname": "Karim",
"name": "Mohamed Salisu Abdul Karim",
"display_name": "Mohammed Salisu",
"image_path": "https:\/\/cdn.sportmonks.com\/images\/soccer\/players\/8\/11347016.png",
"height": 188,
"weight": 82,
"date_of_birth": "1999-04-17",
"gender": "male"
}
},
{
"id": 468800,
"fixture_id": 19134562,
"sideline_id": 112255,
"participant_id": 65,
"player_id": 337432,
"type_id": 1618,
"sideline": {
"id": 112255,
"player_id": 337432,
"type_id": 1618,
"category": "out",
"team_id": 65,
"season_id": null,
"start_date": "2023-05-27",
"end_date": null,
"games_missed": null,
"completed": false
},
"player": {
"id": 337432,
"sport_id": 1,
"country_id": 17,
"nationality_id": 17,
"city_id": null,
"position_id": 25,
"detailed_position_id": 155,
"type_id": 25,
"common_name": "R. Perraud",
"firstname": "Romain",
"lastname": "Perraud",
"name": "Romain Perraud",
"display_name": "Romain Perraud",
"image_path": "https:\/\/cdn.sportmonks.com\/images\/soccer\/players\/24\/337432.png",
"height": 173,
"weight": 68,
"date_of_birth": "1997-09-22",
"gender": "male"
}
},
{
"id": 468801,
"fixture_id": 19134562,
"sideline_id": 112252,
"participant_id": 65,
"player_id": 37316841,
"type_id": 587,
"sideline": {
"id": 112252,
"player_id": 37316841,
"type_id": 587,
"category": "unknown-injury",
"team_id": 65,
"season_id": null,
"start_date": "2023-05-27",
"end_date": null,
"games_missed": null,
"completed": false
},
"player": {
"id": 37316841,
"sport_id": 1,
"country_id": 462,
"nationality_id": 462,
"city_id": null,
"position_id": 27,
"detailed_position_id": 152,
"type_id": 27,
"common_name": "S. Edozie",
"firstname": "Samuel",
"lastname": "Edozie",
"name": "Samuel Edozie",
"display_name": "Samuel Edozie",
"image_path": "https:\/\/cdn.sportmonks.com\/images\/soccer\/players\/9\/37316841.png",
"height": 181,
"weight": null,
"date_of_birth": "2003-01-28",
"gender": "male"
}
},
{
"id": 468802,
"fixture_id": 19134562,
"sideline_id": 112254,
"participant_id": 65,
"player_id": 37537876,
"type_id": 1618,
"sideline": {
"id": 112254,
"player_id": 37537876,
"type_id": 1618,
"category": "out",
"team_id": 65,
"season_id": null,
"start_date": "2023-05-27",
"end_date": null,
"games_missed": null,
"completed": false
},
"player": {
"id": 37537876,
"sport_id": 1,
"country_id": 32,
"nationality_id": 32,
"city_id": null,
"position_id": 25,
"detailed_position_id": 155,
"type_id": 25,
"common_name": "J. Larios L\u00f3pez",
"firstname": "Juan",
"lastname": "Larios L\u00f3pez",
"name": "Juan Larios L\u00f3pez",
"display_name": "Juan Larios",
"image_path": "https:\/\/cdn.sportmonks.com\/images\/soccer\/players\/20\/37537876.png",
"height": 170,
"weight": null,
"date_of_birth": "2004-01-12",
"gender": "male"
}
},
{
"id": 468791,
"fixture_id": 19134562,
"sideline_id": 112277,
"participant_id": 14,
"player_id": 1454,
"type_id": 1618,
"sideline": {
"id": 112277,
"player_id": 1454,
"type_id": 1618,
"category": "out",
"team_id": 14,
"season_id": null,
"start_date": "2023-08-21",
"end_date": null,
"games_missed": null,
"completed": false
},
"player": {
"id": 1454,
"sport_id": 1,
"country_id": 462,
"nationality_id": 462,
"city_id": null,
"position_id": 24,
"detailed_position_id": 24,
"type_id": 24,
"common_name": "T. Heaton",
"firstname": "Tom",
"lastname": "Heaton",
"name": "Tom Heaton",
"display_name": "Tom Heaton",
"image_path": "https:\/\/cdn.sportmonks.com\/images\/soccer\/players\/14\/1454.png",
"height": 188,
"weight": 85,
"date_of_birth": "1986-04-15",
"gender": "male"
}
},
{
"id": 468792,
"fixture_id": 19134562,
"sideline_id": 692738,
"participant_id": 14,
"player_id": 164061,
"type_id": 1610,
"sideline": {
"id": 692738,
"player_id": 164061,
"type_id": 1610,
"category": "suspended",
"team_id": 14,
"season_id": null,
"start_date": "2025-01-13",
"end_date": "2025-01-16",
"games_missed": 0,
"completed": true
},
"player": {
"id": 164061,
"sport_id": 1,
"country_id": 20,
"nationality_id": 20,
"city_id": null,
"position_id": 25,
"detailed_position_id": 154,
"type_id": 25,
"common_name": "J. Dalot Teixeira",
"firstname": "Jos\u00e9 Diogo",
"lastname": "Dalot Teixeira",
"name": "Jos\u00e9 Diogo Dalot Teixeira",
"display_name": "Diogo Dalot",
"image_path": "https:\/\/cdn.sportmonks.com\/images\/soccer\/players\/29\/164061.png",
"height": 183,
"weight": null,
"date_of_birth": "1999-03-18",
"gender": "male"
}
},
{
"id": 468793,
"fixture_id": 19134562,
"sideline_id": 112292,
"participant_id": 14,
"player_id": 28912805,
"type_id": 1619,
"sideline": {
"id": 112292,
"player_id": 28912805,
"type_id": 1619,
"category": "doubtful",
"team_id": 63,
"season_id": null,
"start_date": "2023-09-18",
"end_date": null,
"games_missed": null,
"completed": false
},
"player": {
"id": 28912805,
"sport_id": 1,
"country_id": 47,
"nationality_id": 47,
"city_id": null,
"position_id": 27,
"detailed_position_id": 152,
"type_id": 27,
"common_name": "A. Elanga",
"firstname": "Anthony",
"lastname": "Elanga",
"name": "Anthony Elanga",
"display_name": "Anthony Elanga",
"image_path": "https:\/\/cdn.sportmonks.com\/images\/soccer\/players\/5\/28912805.png",
"height": 178,
"weight": null,
"date_of_birth": "2002-04-27",
"gender": "male"
}
},
{
"id": 468794,
"fixture_id": 19134562,
"sideline_id": 112280,
"participant_id": 14,
"player_id": 2158417,
"type_id": 1618,
"sideline": {
"id": 112280,
"player_id": 2158417,
"type_id": 1618,
"category": "out",
"team_id": 14,
"season_id": null,
"start_date": "2023-08-21",
"end_date": null,
"games_missed": null,
"completed": false
},
"player": {
"id": 2158417,
"sport_id": 1,
"country_id": 38,
"nationality_id": 38,
"city_id": null,
"position_id": 25,
"detailed_position_id": 155,
"type_id": 25,
"common_name": "T. Malacia",
"firstname": "Tyrell",
"lastname": "Malacia",
"name": "Tyrell Malacia",
"display_name": "Tyrell Malacia",
"image_path": "https:\/\/cdn.sportmonks.com\/images\/soccer\/players\/17\/2158417.png",
"height": 169,
"weight": 67,
"date_of_birth": "1999-08-17",
"gender": "male"
}
},
{
"id": 468795,
"fixture_id": 19134562,
"sideline_id": 112304,
"participant_id": 14,
"player_id": 12393293,
"type_id": 1546,
"sideline": {
"id": 112304,
"player_id": 12393293,
"type_id": 1546,
"category": "suspended",
"team_id": 14,
"season_id": null,
"start_date": "2023-09-10",
"end_date": null,
"games_missed": null,
"completed": false
},
"player": {
"id": 12393293,
"sport_id": 1,
"country_id": 5,
"nationality_id": 5,
"city_id": null,
"position_id": 27,
"detailed_position_id": 156,
"type_id": 27,
"common_name": "A. dos Santos",
"firstname": "Antony Matheus",
"lastname": "dos Santos",
"name": "Antony Matheus dos Santos",
"display_name": "Antony",
"image_path": "https:\/\/cdn.sportmonks.com\/images\/soccer\/players\/13\/12393293.png",
"height": 172,
"weight": null,
"date_of_birth": "2000-02-24",
"gender": "male"
}
},
{
"id": 468796,
"fixture_id": 19134562,
"sideline_id": 112251,
"participant_id": 65,
"player_id": 27066567,
"type_id": 1618,
"sideline": {
"id": 112251,
"player_id": 27066567,
"type_id": 1618,
"category": "out",
"team_id": 65,
"season_id": null,
"start_date": "2023-05-27",
"end_date": null,
"games_missed": null,
"completed": false
},
"player": {
"id": 27066567,
"sport_id": 1,
"country_id": 11,
"nationality_id": 11,
"city_id": null,
"position_id": 25,
"detailed_position_id": 148,
"type_id": 25,
"common_name": "A. Bella-Kotchap",
"firstname": "Armel",
"lastname": "Bella-Kotchap",
"name": "Armel Bella-Kotchap",
"display_name": "Armel Bella-Kotchap",
"image_path": "https:\/\/cdn.sportmonks.com\/images\/soccer\/players\/7\/27066567.png",
"height": 190,
"weight": null,
"date_of_birth": "2001-12-11",
"gender": "male"
}
},
{
"id": 468797,
"fixture_id": 19134562,
"sideline_id": 3819,
"participant_id": 65,
"player_id": 24799911,
"type_id": 337,
"sideline": {
"id": 3819,
"player_id": 24799911,
"type_id": 337,
"category": "injury",
"team_id": 65,
"season_id": null,
"start_date": "2022-04-25",
"end_date": null,
"games_missed": 68,
"completed": false
},
"player": {
"id": 24799911,
"sport_id": 1,
"country_id": 462,
"nationality_id": 462,
"city_id": null,
"position_id": 25,
"detailed_position_id": 154,
"type_id": 25,
"common_name": "V. Livramento",
"firstname": "Valentino",
"lastname": "Livramento",
"name": "Valentino Livramento",
"display_name": "Tino Livramento\u00a0",
"image_path": "https:\/\/cdn.sportmonks.com\/images\/soccer\/players\/7\/24799911.png",
"height": 173,
"weight": null,
"date_of_birth": "2002-11-12",
"gender": "male"
}
}
]
}
}1.7 Predictive Line-ups
Another cool feature that has to do with the line-ups is predictive line-ups. In API 3.0, getting a line-up before the definitive line-up is released is now possible. When you use the “Fixture By ID” endpoint with the lineup include, you will see a line-up way before the actual line-up is released.
By using the include metadata, you can find the lineup_confirmed type. The type will be false if the club has yet to release the line-up. This is when we show a predicted line-up based on previous line-ups in games, suspended and injured players.
https://api.sportmonks.com/v3/football/fixtures/19380884?api_token=YOURTOKEN&include=lineups;metadataResponse
{
"data": {
"id": 19380884,
"sport_id": 1,
"league_id": 2,
"season_id": 23619,
"stage_id": 77471316,
"group_id": null,
"aggregate_id": 58591,
"round_id": null,
"state_id": 1,
"venue_id": 53,
"name": "FC Bayern München vs Celtic",
"starting_at": "2025-02-18 20:00:00",
"result_info": null,
"leg": "2/2",
"details": null,
"length": 90,
"placeholder": false,
"has_odds": true,
"has_premium_odds": true,
"starting_at_timestamp": 1739908800,
"lineups": [
{
"id": 14668984020,
"sport_id": 1,
"fixture_id": 19380884,
"player_id": 169,
"team_id": 53,
"position_id": 24,
"formation_field": "1:1",
"type_id": 11,
"formation_position": 1,
"player_name": "Kasper Schmeichel",
"jersey_number": 1
},
{
"id": 14668984021,
"sport_id": 1,
"fixture_id": 19380884,
"player_id": 35659846,
"team_id": 53,
"position_id": 25,
"formation_field": "2:4",
"type_id": 11,
"formation_position": 2,
"player_name": "Alistair Johnston",
"jersey_number": 2
},
{
"id": 14668984022,
"sport_id": 1,
"fixture_id": 19380884,
"player_id": 173080,
"team_id": 53,
"position_id": 25,
"formation_field": "2:1",
"type_id": 11,
"formation_position": 5,
"player_name": "Greg Taylor",
"jersey_number": 3
},
{
"id": 14668984023,
"sport_id": 1,
"fixture_id": 19380884,
"player_id": 262280,
"team_id": 53,
"position_id": 25,
"formation_field": "2:2",
"type_id": 11,
"formation_position": 4,
"player_name": "Auston Trusty",
"jersey_number": 6
},
{
"id": 14668985946,
"sport_id": 1,
"fixture_id": 19380884,
"player_id": 163711,
"team_id": 53,
"position_id": 27,
"formation_field": "4:1",
"type_id": 11,
"formation_position": 11,
"player_name": "João Pedro Neves Filipe",
"jersey_number": 7
},
{
"id": 14668990256,
"sport_id": 1,
"fixture_id": 19380884,
"player_id": 2178915,
"team_id": 53,
"position_id": 27,
"formation_field": "4:3",
"type_id": 11,
"formation_position": 9,
"player_name": "Nicolas-Gerrit Kühn",
"jersey_number": 10
},
{
"id": 14668984026,
"sport_id": 1,
"fixture_id": 19380884,
"player_id": 1712,
"team_id": 53,
"position_id": 25,
"formation_field": "2:3",
"type_id": 11,
"formation_position": 3,
"player_name": "Cameron Carter-Vickers",
"jersey_number": 20
},
{
"id": 14668984027,
"sport_id": 1,
"fixture_id": 19380884,
"player_id": 37337212,
"team_id": 53,
"position_id": 26,
"formation_field": "3:3",
"type_id": 11,
"formation_position": 6,
"player_name": "Arne Engels",
"jersey_number": 27
},
{
"id": 14668984028,
"sport_id": 1,
"fixture_id": 19380884,
"player_id": 319282,
"team_id": 53,
"position_id": 27,
"formation_field": "4:2",
"type_id": 11,
"formation_position": 10,
"player_name": "Daizen Maeda",
"jersey_number": 38
},
{
"id": 14668984029,
"sport_id": 1,
"fixture_id": 19380884,
"player_id": 10966261,
"team_id": 53,
"position_id": 26,
"formation_field": "3:1",
"type_id": 11,
"formation_position": 8,
"player_name": "Reo Hatate",
"jersey_number": 41
},
{
"id": 14668984030,
"sport_id": 1,
"fixture_id": 19380884,
"player_id": 8585,
"team_id": 53,
"position_id": 26,
"formation_field": "3:2",
"type_id": 11,
"formation_position": 7,
"player_name": "Callum McGregor",
"jersey_number": 42
},
{
"id": 14668984031,
"sport_id": 1,
"fixture_id": 19380884,
"player_id": 30642,
"team_id": 503,
"position_id": 24,
"formation_field": "1:1",
"type_id": 11,
"formation_position": 1,
"player_name": "Manuel Neuer",
"jersey_number": 1
},
{
"id": 14668984032,
"sport_id": 1,
"fixture_id": 19380884,
"player_id": 33685,
"team_id": 503,
"position_id": 25,
"formation_field": "2:2",
"type_id": 11,
"formation_position": 3,
"player_name": "Dayotchanculle Upamecano",
"jersey_number": 2
},
{
"id": 14668984033,
"sport_id": 1,
"fixture_id": 19380884,
"player_id": 322964,
"team_id": 503,
"position_id": 25,
"formation_field": "2:3",
"type_id": 11,
"formation_position": 4,
"player_name": "Min-Jae Kim",
"jersey_number": 3
},
{
"id": 14668984034,
"sport_id": 1,
"fixture_id": 19380884,
"player_id": 32362,
"team_id": 503,
"position_id": 26,
"formation_field": "3:1",
"type_id": 11,
"formation_position": 6,
"player_name": "Joshua Kimmich",
"jersey_number": 6
},
{
"id": 14668990257,
"sport_id": 1,
"fixture_id": 19380884,
"player_id": 31824,
"team_id": 503,
"position_id": 26,
"formation_field": "3:2",
"type_id": 11,
"formation_position": 7,
"player_name": "Leon Goretzka",
"jersey_number": 8
},
{
"id": 14668984035,
"sport_id": 1,
"fixture_id": 19380884,
"player_id": 997,
"team_id": 503,
"position_id": 27,
"formation_field": "5:1",
"type_id": 11,
"formation_position": 11,
"player_name": "Harry Kane",
"jersey_number": 9
},
{
"id": 14668985948,
"sport_id": 1,
"fixture_id": 19380884,
"player_id": 4783,
"team_id": 503,
"position_id": 27,
"formation_field": "4:3",
"type_id": 11,
"formation_position": 10,
"player_name": "Leroy Sané",
"jersey_number": 10
},
{
"id": 14668984037,
"sport_id": 1,
"fixture_id": 19380884,
"player_id": 24799984,
"team_id": 503,
"position_id": 27,
"formation_field": "4:1",
"type_id": 11,
"formation_position": 8,
"player_name": "Michael Olise",
"jersey_number": 17
},
{
"id": 14668984691,
"sport_id": 1,
"fixture_id": 19380884,
"player_id": 32397,
"team_id": 503,
"position_id": 25,
"formation_field": "2:4",
"type_id": 11,
"formation_position": 5,
"player_name": "Raphaël Adelino José Guerreiro",
"jersey_number": 22
},
{
"id": 14668984040,
"sport_id": 1,
"fixture_id": 19380884,
"player_id": 33186829,
"team_id": 503,
"position_id": 26,
"formation_field": "4:2",
"type_id": 11,
"formation_position": 9,
"player_name": "Jamal Musiala",
"jersey_number": 42
},
{
"id": 14668985949,
"sport_id": 1,
"fixture_id": 19380884,
"player_id": 3862426,
"team_id": 503,
"position_id": 25,
"formation_field": "2:1",
"type_id": 11,
"formation_position": 2,
"player_name": "Josip Stanisic",
"jersey_number": 44
}
],
"metadata": [
{
"id": 7621295,
"metadatable_id": 19380884,
"type_id": 35,
"value_type": "object",
"values": {
"neutral": false
}
},
{
"id": 7637243,
"metadatable_id": 19380884,
"type_id": 36,
"value_type": "object",
"values": {
"kickOff": "home"
}
},
{
"id": 7621296,
"metadatable_id": 19380884,
"type_id": 159,
"value_type": "object",
"values": {
"home": "4-2-3-1",
"away": "4-3-3"
}
},
{
"id": 7621297,
"metadatable_id": 19380884,
"type_id": 572,
"value_type": "object",
"values": {
"confirmed": false
}
},
{
"id": 7612313,
"metadatable_id": 19380884,
"type_id": 613,
"value_type": "string",
"values": "#FCBCEL"
},
{
"id": 7621298,
"metadatable_id": 19380884,
"type_id": 2838,
"value_type": "object",
"values": {
"extra_time": false
}
},
{
"id": 7567168,
"metadatable_id": 19380884,
"type_id": 37072,
"value_type": "object",
"values": {
"predictable": true
}
}
]
},Once the team/club officially releases their line-up, it will be set to true. Then the line-up we offer should reflect the final line-up as it is during the game.
Now, let's explain how you can display the lineups in a visual manner.
2. Displaying lineups in your football application
The lineup display in the application is based on a structured approach that ensures consistency across formations, formation positions, and detailed positions. The new processor streamlines the logic to eliminate discrepancies in the formation_field.
Rules of thumb:
The formation position and formation determine the detailed position and formation field.
The formation position is permanently assigned from bottom to top (for vertical formations) or right to left (for horizontal formations), relative to the home and away teams’ perspectives.
2.1 Formation Data Structure
Each team lineup consists of:
Formation position – The numerical placement of a player within the formation. (1-11)
Formation Field – The formation field provides a grid-based coordinate to visually position players on the field, making it easier to display them in a tactical formation view. (Formatted as line:line_position - like 2:4)
Detailed Position – The player's role based on their placement in the formation. (type ids)
2.2 Example Match: Manchester City vs. Real Madrid
Home Team: Manchester City
Formation: 4-1-4-1
Formation Positions & Mapping:
Player
Formation Position
Formation Field
Detailed Position
Ederson
1
1:1
Goalkeeper
Akanji
2
2:1
Right-back
Dias
3
2:2
Centre-back
Ake
4
2:3
Centre-back
Gvardiol
5
2:4
Left-back
Stones
6
3:1
Defensive Midfield
Savio
7
4:1
Right Midfield
De Bruyne
8
4:2
Central Midfield
Silva
9
4:3
Central Midfield
Grealish
10
4:4
Left Midfield
Haaland
11
5:1
Attacker
Away Team: Real Madrid
Formation: 4-4-2
Formation Positions & Mapping:
Player
Formation Position
Formation Field
Detailed Position
Courtois
1
1:1
Goalkeeper
Valverde
2
2:4
Right-back
Tchouameni
3
2:3
Centre-back
Asencio
4
2:2
Centre-back
Mendy
5
2:1
Left-back
Rodrygo
6
3:4
Right Midfield
Camavinga
7
3:3
Central Midfield
Ceballos
8
3:2
Central Midfield
Bellingham
9
3:1
Left Midfield
Mbappé
10
4:2
Attacker
Vinicius Jr.
11
4:1
Attacker
4. Summary
The formation position determines a player's numerical position within the formation.
The formation field provides a structured coordinate system for lineup display.
The detailed position assigns standard football roles based on formation positioning.
The new logic ensures consistency and accuracy in displaying formations across all teams.
Last updated
Was this helpful?