# Get match lineup

Returns the full lineup for both teams in a given match, including starters, substitutes, and coaches.

Endpoint: GET /match-lineup
Version: 2.0.7
Security: bearerAuth

## Query parameters:

  - `id` (integer, required)
    Match ID
    Example: 372452

## Response 200 fields (application/json):

  - `status` (string)
    Example: "success"

  - `pagination` (object,null)
    Pagination info if applicable

  - `errors` (object,null)

  - `response` (array,null)
    Lineup for both teams

  - `response.team_id` (integer)
    The ID of the team
    Example: 33

  - `response.coach` (string)
    Name of the team's coach
    Example: "Pep Guardiola"

  - `response.coach_photo` (string,null)
    URL of the coach's photo
    Example: "https://cdn.goalise.com/images/coaches/1.png"

  - `response.player_colors` (object)
    Jersey colors of the players

  - `response.player_colors.border` (string)
    Example: "232325"

  - `response.player_colors.number` (string)
    Example: "050505"

  - `response.player_colors.primary` (string)
    Example: "dc2c36"

  - `response.goal_keeper_colors` (object)
    Jersey colors of the goal keeper

  - `response.formation` (string)
    Formation used by the team
    Example: "4-3-3"

  - `response.startXI` (array)
    List of LineUpPlayer

  - `response.startXI.player_id` (integer,null)
    The ID of the player from the main player table, if available
    Example: 123

  - `response.startXI.name` (string)
    The full name of the player as listed in the lineup
    Example: "Lionel Messi"

  - `response.startXI.number` (integer,null)
    Jersey number of the player
    Example: 10

  - `response.startXI.position` (string,null)
    Position of the player on the field
    Example: "Forward"

  - `response.startXI.composition` (string)
    Player's role in the lineup (e.g., Starting XI, Substitute)
    Example: "Starting XI"

  - `response.startXI.grid` (string,null)
    Player's position in the grid formation
    Example: "4:3"

  - `response.startXI.photo` (string,null)
    URL to the player's photo
    Example: "https://example.com/images/players/player.png"

  - `response.startXI.statistics` (object,null)
    Detailed match statistics for the player

  - `response.startXI.statistics.cards` (object)
    Player's card statistics (yellow and red cards)

  - `response.startXI.statistics.cards.red` (integer,null)
    Number of red cards

  - `response.startXI.statistics.cards.yellow` (integer,null)
    Number of yellow cards

  - `response.startXI.statistics.duels` (object)
    Player's duel statistics (won and total duels)

  - `response.startXI.statistics.duels.won` (integer,null)
    Number of duels won

  - `response.startXI.statistics.duels.total` (integer,null)
    Total number of duels contested

  - `response.startXI.statistics.fouls` (object)
    Player's foul statistics (drawn and committed fouls)

  - `response.startXI.statistics.fouls.drawn` (integer,null)
    Number of fouls drawn by the player

  - `response.startXI.statistics.fouls.committed` (integer,null)
    Number of fouls committed by the player

  - `response.startXI.statistics.games` (object)
    Player's game statistics

  - `response.startXI.statistics.games.number` (integer,null)
    Number of games played
    Example: 1

  - `response.startXI.statistics.games.rating` (string,null)
    Player's performance rating
    Example: "7"

  - `response.startXI.statistics.games.captain` (boolean)
    Indicates if the player was the captain

  - `response.startXI.statistics.games.minutes` (integer,null)
    Total minutes played in the match
    Example: 95

  - `response.startXI.statistics.games.position` (string,null)
    Player's position on the field
    Example: "G"

  - `response.startXI.statistics.games.substitute` (boolean)
    Indicates if the player was substituted

  - `response.startXI.statistics.goals` (object)
    Player's goal-related statistics

  - `response.startXI.statistics.goals.saves` (integer,null)
    Number of saves made (for goalkeepers)
    Example: 3

  - `response.startXI.statistics.goals.total` (integer,null)
    Total number of goals scored

  - `response.startXI.statistics.goals.assists` (integer,null)
    Number of assists made

  - `response.startXI.statistics.goals.conceded` (integer,null)
    Number of goals conceded (for goalkeepers)

  - `response.startXI.statistics.shots` (object)
    Player's shot statistics

  - `response.startXI.statistics.shots.on` (integer,null)
    Number of shots on target

  - `response.startXI.statistics.shots.total` (integer,null)
    Total number of shots taken

  - `response.startXI.statistics.passes` (object)
    Player's pass statistics

  - `response.startXI.statistics.passes.key` (integer,null)
    Number of key passes

  - `response.startXI.statistics.passes.total` (integer,null)
    Total number of passes made
    Example: 27

  - `response.startXI.statistics.passes.accuracy` (string,null)
    Pass accuracy percentage
    Example: "15"

  - `response.startXI.statistics.penalty` (object)
    Player's penalty statistics

  - `response.startXI.statistics.penalty.won` (integer,null)
    Number of penalties won by the player

  - `response.startXI.statistics.penalty.saved` (integer,null)
    Number of penalties saved (for goalkeepers)

  - `response.startXI.statistics.penalty.missed` (integer,null)
    Number of penalties missed

  - `response.startXI.statistics.penalty.scored` (integer,null)
    Number of penalties scored

  - `response.startXI.statistics.penalty.commited` (integer,null)
    Number of penalties committed by the player

  - `response.startXI.statistics.tackles` (object)
    Player's tackle statistics

  - `response.startXI.statistics.tackles.total` (integer,null)
    Total number of tackles made

  - `response.startXI.statistics.tackles.blocks` (integer,null)
    Number of tackles that were blocks

  - `response.startXI.statistics.tackles.interceptions` (integer,null)
    Number of interceptions made

  - `response.startXI.statistics.dribbles` (object)
    Player's dribble statistics

  - `response.startXI.statistics.dribbles.past` (integer,null)
    Number of dribbles past opponents

  - `response.startXI.statistics.dribbles.success` (integer,null)
    Number of successful dribbles

  - `response.startXI.statistics.dribbles.attempts` (integer,null)
    Number of dribble attempts

  - `response.startXI.statistics.offsides` (integer,null)
    Number of offsides the player was involved in

  - `response.substitutes` (array)
    List of LineUpPlayer

## Response 400 fields (application/json):

  - `status` (string)
    Example: "error"

  - `pagination` (object,null)

  - `errors` (array,null)

  - `errors.type` (string)
    Example: "validation_error"

  - `errors.data` (object)

  - `response` (object,null)

## Response 500 fields (application/json):

  - `status` (string)
    Example: "error"

  - `pagination` (object,null)

  - `errors` (array,null)

  - `errors.type` (string)
    Example: "validation_error"

  - `errors.data` (object)

  - `response` (object,null)