Matches Lineups

This endpoint allows you to retrieve the lineups from matches. With this endpoint you can see the lineups from the match. This endpoint also has confirmed filed to check if the lineup is confirmed.

Fields in lineup:

Field	Explanation
formation	The formation of the lineup
player_color_primary	The primary color of the players
player_color_number	The number color of the players
player_color_outline	The outline color of the players
goalkeeper_color_primary	The primary color of the goalkeeper
goalkeeper_color_number	The number color of the goalkeeper
goalkeeper_color_outline	The outline color of the goalkeeper
players	The players of the lineup

Fields in players:

Field	Explanation
player_id	The id of the player
shirt_number	The shirt number of the player
jersey_number	The jersey number of the player
position	The position of the player
substitute	If the player is substituted

Resons for missing the match:

Id	Reason
0	Other
1	Injured
2	Ill
3	Suspended
11	YellowCard
12	YellowRedCard
13	RedCard
21	OnLoan

Multi-language: This feature allows the user to manually change the language of the API response by adding value to the lang attribute. Example: lang=en.

Pagination: The endpoint uses an offset and limit system. Specify the offset and limit parameters to fetch the desired range of results. The maximum and default number of results per request is 50.

Update Period: The endpoint is updated every 5 minutes. Recommended Calls: Limit calls to 1 every 5 minutes.

Use Cases

Get lineups based on the id
https://football.sportdevs.com/matches-lineups?id=eq.{id}

Query Parameters

• id integer

  Default value: eq.1

  The id of the lineup

• offset string

  Default value: 0

  Limiting and Pagination

• limit string

  Default value: 50

  Limiting and Pagination

• lang string

  Default value: en

  Multi-language

Responses

• 200

---

OK

application/json

• Schema
• Example (from schema)

---

Schema array

• id integer

  The id of the lineup

  Note: This is a Primary Key.

• confirmed boolean

  If the lineup is confirmed

• home_team jsonb

  The lineup of the home team

• away_team jsonb

  The lineup of the away team

[
  {
    "id": 1,
    "confirmed": true,
    "home_team": {
      "players": [
        {
          "position": "D",
          "player_id": 732,
          "substitute": true,
          "player_name": "Karl Ouimette",
          "shirt_number": 20,
          "jersey_number": "20",
          "player_hash_image": "7d2f68fa359974f3abde832502d6ed506ffd6d5dc79299778c19caee48a808be"
        },
        {
          "position": "D",
          "player_id": 841,
          "substitute": false,
          "player_name": "Maxime Tissot",
          "shirt_number": 15,
          "jersey_number": "15",
          "player_hash_image": "b5dd17932b2af430b10e051ddb6deffb54df6d956fbf8d3e3693d079e1221317",
          "player_statistics_id": 36
        },
        {
          "position": "F",
          "player_id": 756,
          "substitute": true,
          "player_name": "Pablo Dyego",
          "shirt_number": 11,
          "jersey_number": "11",
          "player_hash_image": "abce5332d4fceb6e0df7293261d8b85c4b98fbee9a8f72ff2959da67e14a78b7",
          "player_statistics_id": 51
        },
        {
          "position": "F",
          "player_id": 870,
          "substitute": false,
          "player_name": "Devon Sandoval",
          "shirt_number": 17,
          "jersey_number": "17",
          "player_hash_image": "6706181931b1a975fc7a92eafff3884aeb9632b58df4c5d33dcdbe34f7589495",
          "player_statistics_id": 49
        },
        {
          "position": "F",
          "player_id": 880,
          "substitute": false,
          "player_name": "Kyle Bekker",
          "shirt_number": 10,
          "jersey_number": "10",
          "player_hash_image": "8b5743eb6337b608705f92cbc53e94afb6b712768063a19ed57cfbb3f8657fd5",
          "player_statistics_id": 50
        },
        {
          "position": "G",
          "player_id": 835,
          "substitute": false,
          "player_name": "Steward Ceus",
          "shirt_number": 12,
          "jersey_number": "12",
          "player_hash_image": "406d18d06e83d4db8bf317e65f779f18477e594b671c264f0ffaebda2d6ae436",
          "player_statistics_id": 30
        },
        {
          "position": "M",
          "player_id": 851,
          "substitute": false,
          "player_name": "Jackson Goncalves",
          "shirt_number": 7,
          "jersey_number": "7",
          "player_hash_image": "80bb834bd6a9ee66de4b71dbf5e3306992be695a1e02e69116da63458ca4a2fd",
          "player_statistics_id": 40
        },
        {
          "position": "M",
          "player_id": 860,
          "substitute": false,
          "player_name": "Michael Stephens",
          "shirt_number": 30,
          "jersey_number": "30",
          "player_hash_image": "b926925c60e99f99a358c02814cc3aaef531000fd64629856aa77f2928a977a7",
          "player_statistics_id": 44
        }
      ],
      "formation": "4-4-2",
      "player_color_number": "ff0000",
      "player_color_primary": "000000"
    },
    "away_team": {
      "players": [
        {
          "position": "D",
          "player_id": 732,
          "substitute": true,
          "player_name": "Karl Ouimette",
          "shirt_number": 20,
          "jersey_number": "20",
          "player_hash_image": "7d2f68fa359974f3abde832502d6ed506ffd6d5dc79299778c19caee48a808be"
        },
        {
          "position": "D",
          "player_id": 841,
          "substitute": false,
          "player_name": "Maxime Tissot",
          "shirt_number": 15,
          "jersey_number": "15",
          "player_hash_image": "b5dd17932b2af430b10e051ddb6deffb54df6d956fbf8d3e3693d079e1221317",
          "player_statistics_id": 36
        },
        {
          "position": "F",
          "player_id": 756,
          "substitute": true,
          "player_name": "Pablo Dyego",
          "shirt_number": 11,
          "jersey_number": "11",
          "player_hash_image": "abce5332d4fceb6e0df7293261d8b85c4b98fbee9a8f72ff2959da67e14a78b7",
          "player_statistics_id": 51
        },
        {
          "position": "F",
          "player_id": 870,
          "substitute": false,
          "player_name": "Devon Sandoval",
          "shirt_number": 17,
          "jersey_number": "17",
          "player_hash_image": "6706181931b1a975fc7a92eafff3884aeb9632b58df4c5d33dcdbe34f7589495",
          "player_statistics_id": 49
        },
        {
          "position": "F",
          "player_id": 880,
          "substitute": false,
          "player_name": "Kyle Bekker",
          "shirt_number": 10,
          "jersey_number": "10",
          "player_hash_image": "8b5743eb6337b608705f92cbc53e94afb6b712768063a19ed57cfbb3f8657fd5",
          "player_statistics_id": 50
        },
        {
          "position": "G",
          "player_id": 835,
          "substitute": false,
          "player_name": "Steward Ceus",
          "shirt_number": 12,
          "jersey_number": "12",
          "player_hash_image": "406d18d06e83d4db8bf317e65f779f18477e594b671c264f0ffaebda2d6ae436",
          "player_statistics_id": 30
        },
        {
          "position": "M",
          "player_id": 851,
          "substitute": false,
          "player_name": "Jackson Goncalves",
          "shirt_number": 7,
          "jersey_number": "7",
          "player_hash_image": "80bb834bd6a9ee66de4b71dbf5e3306992be695a1e02e69116da63458ca4a2fd",
          "player_statistics_id": 40
        },
        {
          "position": "M",
          "player_id": 860,
          "substitute": false,
          "player_name": "Michael Stephens",
          "shirt_number": 30,
          "jersey_number": "30",
          "player_hash_image": "b926925c60e99f99a358c02814cc3aaef531000fd64629856aa77f2928a977a7",
          "player_statistics_id": 44
        }
      ],
      "formation": "4-3-3",
      "player_color_number": "006400",
      "player_color_primary": "ffffff"
    }
  }
]

Loading...