Message: events_lineups

This type of message is sent when we provide match lineups, i.e. when the match detail "has_lineups" changes its value to "=yes" or "=probable". The message is also sent when we make changes to already shared lineups.

Please note:

This type of message is only sent to STATSCORE partners with:

access to GOLD or VIP package - SportsAPI
ScoutsFeed product with PUSH players stats add-on

Message example:

{
  "id": 689967753,
  "uuid": "0d8611d3-26ac-4ecc-9f03-b02d9b25dae8",
  "type": "events_lineups",
  "source": 1148,
  "ut": 1684823068,
  "data": {
    "eventlineupsinfo": {
      "id": 4513932,
      "sport_id": 5,
      "lineups": [
        {
          "id": 10344298,
          "participant_name": "Ederson",
          "participant_id": 319576,
          "participant_team_id": 136196,
          "participant_position": "goalkeeper",
          "participant_shirt_number": 31,
          "participant_is_captain": false,
          "position_type": "starting lineup"
        },
        {
          "id": 10344301,
          "participant_name": "Ante Palaversa",
          "participant_id": 1044617,
          "participant_team_id": 136196,
          "participant_position": "bench",
          "participant_shirt_number": null,
          "participant_is_captain": false,
          "position_type": "substitute"
        },
        {
          "id": 10344292,
          "participant_name": "Erling Haaland",
          "participant_id": 1000296,
          "participant_team_id": 136196,
          "participant_position": "1st lineup",
          "participant_shirt_number": null,
          "participant_is_captain": false,
          "position_type": "starting lineup"
        },
        {
          "id": 10344300,
          "participant_name": "Arijanet Muric",
          "participant_id": 1048528,
          "participant_team_id": 136196,
          "participant_position": "1st lineup",
          "participant_shirt_number": 49,
          "participant_is_captain": false,
          "position_type": "starting lineup"
        },
        {
          "id": 10344297,
          "participant_name": "Ilkay Gundogan",
          "participant_id": 195762,
          "participant_team_id": 136196,
          "participant_position": "1st lineup",
          "participant_shirt_number": 8,
          "participant_is_captain": false,
          "position_type": "starting lineup"
        },
        {
          "id": 10344291,
          "participant_name": "Bernardo Silva",
          "participant_id": 374728,
          "participant_team_id": 136196,
          "participant_position": "1st lineup",
          "participant_shirt_number": 20,
          "participant_is_captain": false,
          "position_type": "starting lineup"
        },
        {
          "id": 10344293,
          "participant_name": "Jack Grealish",
          "participant_id": 325503,
          "participant_team_id": 136196,
          "participant_position": "1st lineup",
          "participant_shirt_number": 10,
          "participant_is_captain": false,
          "position_type": "starting lineup"
        },
        {
          "id": 10344294,
          "participant_name": "Kevin De Bruyne",
          "participant_id": 267544,
          "participant_team_id": 136196,
          "participant_position": "1st lineup",
          "participant_shirt_number": 17,
          "participant_is_captain": false,
          "position_type": "starting lineup"
        },
        {
          "id": 10344299,
          "participant_name": "Pep Guardiola",
          "participant_id": 263451,
          "participant_team_id": 136196,
          "participant_position": "coach",
          "participant_shirt_number": null,
          "participant_is_captain": false,
          "position_type": "coach"
        },
        {
          "id": 10344407,
          "participant_name": "Fernandinho",
          "participant_id": 242633,
          "participant_team_id": 136196,
          "participant_position": "bench",
          "participant_shirt_number": 25,
          "participant_is_captain": false,
          "position_type": "substitute"
        },
        {
          "id": 10344296,
          "participant_name": "Kyle Walker",
          "participant_id": 223061,
          "participant_team_id": 136196,
          "participant_position": "1st lineup",
          "participant_shirt_number": 2,
          "participant_is_captain": false,
          "position_type": "starting lineup"
        },
        {
          "id": 10344408,
          "participant_name": "Joao Cancelo",
          "participant_id": 218301,
          "participant_team_id": 136196,
          "participant_position": "bench",
          "participant_shirt_number": 27,
          "participant_is_captain": false,
          "position_type": "substitute"
        },
        {
          "id": 10344302,
          "participant_name": "Aymeric Laporte",
          "participant_id": 208015,
          "participant_team_id": 136196,
          "participant_position": "1st lineup",
          "participant_shirt_number": 14,
          "participant_is_captain": false,
          "position_type": "starting lineup"
        },
        {
          "id": 10344406,
          "participant_name": "Ben Knight",
          "participant_id": 1138268,
          "participant_team_id": 136196,
          "participant_position": "1st lineup",
          "participant_shirt_number": 96,
          "participant_is_captain": false,
          "position_type": "starting lineup"
        },
        {
          "id": 10344303,
          "participant_name": "Cieran Slicker",
          "participant_id": 1147174,
          "participant_team_id": 136196,
          "participant_position": "1st lineup",
          "participant_shirt_number": 84,
          "participant_is_captain": false,
          "position_type": "starting lineup"
        },
        {
          "id": 10344310,
          "participant_name": "Cristian Romero",
          "participant_id": 955059,
          "participant_team_id": 136207,
          "participant_position": "1st lineup",
          "participant_shirt_number": 4,
          "participant_is_captain": false,
          "position_type": "starting lineup"
        },
        {
          "id": 10344311,
          "participant_name": "Dane Scarlett",
          "participant_id": 1121039,
          "participant_team_id": 136207,
          "participant_position": "1st lineup",
          "participant_shirt_number": 44,
          "participant_is_captain": false,
          "position_type": "starting lineup"
        },
        {
          "id": 10344304,
          "participant_name": "Alfie Devine",
          "participant_id": 1126913,
          "participant_team_id": 136207,
          "participant_position": "bench",
          "participant_shirt_number": 45,
          "participant_is_captain": false,
          "position_type": "substitute"
        },
        {
          "id": 10344309,
          "participant_name": "Bryan Gil",
          "participant_id": 1063171,
          "participant_team_id": 136207,
          "participant_position": "1st lineup",
          "participant_shirt_number": 11,
          "participant_is_captain": false,
          "position_type": "starting lineup"
        },
        {
          "id": 10344313,
          "participant_name": "Dejan Kulusevski",
          "participant_id": 1048303,
          "participant_team_id": 136207,
          "participant_position": "1st lineup",
          "participant_shirt_number": 21,
          "participant_is_captain": false,
          "position_type": "starting lineup"
        },
        {
          "id": 10344405,
          "participant_name": "Japhet Tanganga",
          "participant_id": 1046302,
          "participant_team_id": 136207,
          "participant_position": "bench",
          "participant_shirt_number": 25,
          "participant_is_captain": false,
          "position_type": "substitute"
        },
        {
          "id": 10344308,
          "participant_name": "Brandon Austin",
          "participant_id": 1046297,
          "participant_team_id": 136207,
          "participant_position": "1st lineup",
          "participant_shirt_number": 40,
          "participant_is_captain": false,
          "position_type": "starting lineup"
        },
        {
          "id": 10344404,
          "participant_name": "Jack Clarke",
          "participant_id": 1026538,
          "participant_team_id": 136207,
          "participant_position": "bench",
          "participant_shirt_number": 47,
          "participant_is_captain": false,
          "position_type": "substitute"
        },
        {
          "id": 10344314,
          "participant_name": "Emerson Royal",
          "participant_id": 1005674,
          "participant_team_id": 136207,
          "participant_position": "1st lineup",
          "participant_shirt_number": 12,
          "participant_is_captain": false,
          "position_type": "starting lineup"
        },
        {
          "id": 10344305,
          "participant_name": "Alfie Whiteman",
          "participant_id": 984927,
          "participant_team_id": 136207,
          "participant_position": "1st lineup",
          "participant_shirt_number": 41,
          "participant_is_captain": false,
          "position_type": "starting lineup"
        },
        {
          "id": 10344312,
          "participant_name": "Davinson Sanchez",
          "participant_id": 386366,
          "participant_team_id": 136207,
          "participant_position": "1st lineup",
          "participant_shirt_number": 6,
          "participant_is_captain": false,
          "position_type": "starting lineup"
        },
        {
          "id": 10344307,
          "participant_name": "Ben Davies",
          "participant_id": 320164,
          "participant_team_id": 136207,
          "participant_position": "1st lineup",
          "participant_shirt_number": 33,
          "participant_is_captain": false,
          "position_type": "starting lineup"
        },
        {
          "id": 10344403,
          "participant_name": "Hugo Lloris",
          "participant_id": 220807,
          "participant_team_id": 136207,
          "participant_position": "1st lineup",
          "participant_shirt_number": 1,
          "participant_is_captain": false,
          "position_type": "starting lineup"
        },
        {
          "id": 10344401,
          "participant_name": "Harry Kane",
          "participant_id": 206109,
          "participant_team_id": 136207,
          "participant_position": "1st lineup",
          "participant_shirt_number": 10,
          "participant_is_captain": false,
          "position_type": "starting lineup"
        },
        {
          "id": 10344306,
          "participant_name": "Antonio Conte",
          "participant_id": 200067,
          "participant_team_id": 136207,
          "participant_position": "coach",
          "participant_shirt_number": null,
          "participant_is_captain": false,
          "position_type": "coach"
        }
      ]
    }
  }
}

Message structure details:

.message

.message
id	Unique identifier for the message
uuid	Universally unique identifier
type	events_lineups
source	Internal attribute
ut	Information about the date and time of when the message was created. Format UNIX_TIMESTAMP
..data
…eventlineupsinfo
id	Identifier of the event in which change was made
sport_id	Identifier for the sport in which the event is played. The list of available sports you can find in API service method: sports.index
.…lineups
id	Identifier of the event in which change was made
participant_name	Name of the participant
participant_id	Unique identifier of the participant
participant_team_id	Unique identifier for the team for which the participant belongs
participant_position	Position's name for selected sub-participant in the event. More detailed than the position_type parameter. Possible values: Soccer goalkeeper 1st lineup bench coach will not play (significant absence) empty Volleyball starting lineup substitute player coach will not play (significant absence) empty Handball goalkeeper player coach will not play (significant absence) empty Futsal goalkeeper starting lineup substitute player coach will not play (significant absence) empty Ice hockey goalkeeper line 1 line 2 line 3 line 4 substitute player coach will not play (significant absence) empty Basketball starting lineup substitute player coach will not play (significant absence) empty Baseball batter pitcher player coach will not play (significant absence) empty Am. football offense defense substitute player coach will not play (significant absence) empty Cricket player coach will not play (significant absence) empty
participant_shirt_number	The number on player’s shirt
participant_is_captain	Indicate if player is marked as a captain. Possible values: true false
position_type	Position type of selected position. Recommended for distinguishing starting lineups. Possible values: starting lineup (if the sub-participant is in the starting lineup) substitute (if the sub-participant starts on the bench) coach (if the sub-participant is a coach) will not play (if the sub-participant will not play in this game)