HIhighlightly
Football.Lineups

Get linups by match id

Lineups will become available 30 minutes before the game starts or, at the latest, 15 minutes after kickoff.

Refresh interval: Once every 10 minutes

Retrieve home and away team lineups for a specific match.

Understanding the returned data structure is crucial for accurate rendering. The formation and initialLineup fields are closely related. The first row will always include the team's goalkeeper, while subsequent rows will have the number of entries specified by the formation field.

Below is an example of what you can aim to achieve with the lineup endpoint:

Football lineups example

get/football/lineups/{matchId}

Request

Path parameters

matchIdnumber required

Requested match id.

Headers

x-rapidapi-hoststring required

sport-highlights-api.p.rapidapi.com

x-rapidapi-keystring required

Rapid API Token

Response

Example response

{
  "homeTeam": {
    "id": 66311,
    "logo": "https://example.com/logo/preview/66311.png",
    "formation": "4-2-3-1",
    "name": "Angers",
    "substitutes": [
      {
        "id": 24948,
        "name": "Lilian Raolisoa",
        "number": 27,
        "position": "Defender"
      }
    ],
    "initialLineup": [
      [
        {
          "name": "Yahia Fofana",
          "number": 30,
          "position": "Goalkeeper"
        }
      ],
      [
        {
          "name": "Florent Hanin",
          "number": 26,
          "position": "Defender"
        },
        {
          "name": "Jordan Lefort",
          "number": 21,
          "position": "Defender"
        },
        {
          "name": "Cédric Hountondji",
          "number": 22,
          "position": "Defender"
        },
        {
          "name": "Yan Valery",
          "number": 2,
          "position": "Defender"
        }
      ],
      [
        {
          "name": "Himad Abdelli",
          "number": 10,
          "position": "Midfielder"
        },
        {
          "name": "Zinédine Ould Khaled",
          "number": 12,
          "position": "Midfielder"
        }
      ],
      [
        {
          "name": "Justin-Noel Kalumba",
          "number": 17,
          "position": "Midfielder"
        },
        {
          "name": "Pierrick Capelle",
          "number": 15,
          "position": "Midfielder"
        },
        {
          "name": "Farid El Melali",
          "number": 28,
          "position": "Midfielder"
        }
      ],
      [
        {
          "name": "Loïs Diony",
          "number": 9,
          "position": "Forward"
        }
      ]
    ]
  },
  "awayTeam": {
    "id": 66311,
    "logo": "https://example.com/logo/preview/66311.png",
    "formation": "4-2-3-1",
    "name": "Angers",
    "substitutes": [
      {
        "id": 24948,
        "name": "Lilian Raolisoa",
        "number": 27,
        "position": "Defender"
      }
    ],
    "initialLineup": [
      [
        {
          "name": "Yahia Fofana",
          "number": 30,
          "position": "Goalkeeper"
        }
      ],
      [
        {
          "name": "Florent Hanin",
          "number": 26,
          "position": "Defender"
        },
        {
          "name": "Jordan Lefort",
          "number": 21,
          "position": "Defender"
        },
        {
          "name": "Cédric Hountondji",
          "number": 22,
          "position": "Defender"
        },
        {
          "name": "Yan Valery",
          "number": 2,
          "position": "Defender"
        }
      ],
      [
        {
          "name": "Himad Abdelli",
          "number": 10,
          "position": "Midfielder"
        },
        {
          "name": "Zinédine Ould Khaled",
          "number": 12,
          "position": "Midfielder"
        }
      ],
      [
        {
          "name": "Justin-Noel Kalumba",
          "number": 17,
          "position": "Midfielder"
        },
        {
          "name": "Pierrick Capelle",
          "number": 15,
          "position": "Midfielder"
        },
        {
          "name": "Farid El Melali",
          "number": 28,
          "position": "Midfielder"
        }
      ],
      [
        {
          "name": "Loïs Diony",
          "number": 9,
          "position": "Forward"
        }
      ]
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.