Description
Get starting lineups and substitutes for a specific match. Includes player names, positions, jersey numbers, and formation information for both teams.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
key |
string | Yes | Your API key for authentication |
match_id |
integer | Yes | The unique identifier of the match |
lang |
string | No | Language code (es, fr, de, etc.) - defaults to English |
Example Request
GET /lineups?key=YOUR_API_KEY
Example Response
{
"home": {
"team": {
"id": "1439",
"name": "France"
},
"players": [
{
"team_id": "1439",
"id": "13879",
"name": "Presnel Kimpembe",
"substitution": "0",
"shirt_number": "3",
"photo": "https://cdn.worldcupapi.com/players/5/c/0/c/5c0c3007f1af27e1191082e12a27b0b8.png"
},
{
"team_id": "1439",
"id": "14833",
"name": "Ibrahima Konaté",
"substitution": "0",
"shirt_number": "4",
"photo": "https://cdn.worldcupapi.com/players/e/a/b/e/eabeed77c370a6a4258a6373af2d137d.png"
},
{
"team_id": "1439",
"id": "16226",
"name": "Jules Koundé",
"substitution": "0",
"shirt_number": "5",
"photo": "https://cdn.worldcupapi.com/players/9/c/7/7/9c773fbdb174e0964bd32bafde850f87.png"
},
{
"team_id": "1439",
"id": "1331",
"name": "Mattéo Guendouzi",
"substitution": "0",
"shirt_number": "6",
"photo": "https://cdn.worldcupapi.com/players/e/0/7/7/e077e1a544eec4f0307cf5c3c721d944.png"
},
{
"team_id": "1439",
"id": "13888",
"name": "Kylian Mbappé",
"substitution": "0",
"shirt_number": "10",
"photo": "https://cdn.worldcupapi.com/players/d/b/8/1/db817217c5d9b196aa39cfeb0ce889e4.png"
},
{
"team_id": "1439",
"id": "14842",
"name": "Christopher Nkunku",
"substitution": "0",
"shirt_number": "12",
"photo": "https://cdn.worldcupapi.com/players/8/a/a/d/8aad11ad0535421ef52a534d5cce4bd3.png"
},
{
"team_id": "1439",
"id": "11571",
"name": "Boubacar Kamara",
"substitution": "0",
"shirt_number": "13",
"photo": "https://cdn.worldcupapi.com/players/2/0/a/e/20aeb8a8621709e3ac91e891e7c62f8f.png"
},
{
"team_id": "1439",
"id": "9562",
"name": "Adrien Rabiot",
"substitution": "0",
"shirt_number": "14",
"photo": "https://cdn.worldcupapi.com/players/9/2/c/4/92c4661685bf6681f6a33b78ef729658.png"
},
{
"team_id": "1439",
"id": "10753",
"name": "Mike Maignan",
"substitution": "0",
"shirt_number": "16",
"photo": "https://cdn.worldcupapi.com/players/7/6/1/2/761213bcd999998a5b22d22b13db075f.png"
},
{
"team_id": "1439",
"id": "5914",
"name": "Lucas Digne",
"substitution": "0",
"shirt_number": "18",
"photo": "https://cdn.worldcupapi.com/players/d/d/5/b/dd5bfdeb57f7c75d400de61e99d78e2e.png"
},
{
"team_id": "1439",
"id": "14955",
"name": "Karim Benzema",
"substitution": "0",
"shirt_number": "19",
"photo": "https://cdn.worldcupapi.com/players/7/4/3/d/743db4be3c9cfffc0b06d5f7a7ab3f40.png"
},
{
"team_id": "1439",
"id": "18430",
"name": "Hugo Lloris",
"substitution": "1",
"shirt_number": "1",
"photo": "https://cdn.worldcupapi.com/players/d/5/0/9/d5095748fbfebc4b9f93391ec93f1f8c.png"
},
{
"team_id": "1439",
"id": "2377",
"name": "Benjamin Pavard",
"substitution": "1",
"shirt_number": "2",
"photo": "https://cdn.worldcupapi.com/players/2/6/9/d/269d837afada308dd4aeab28ca2d57e4.png"
},
{
"team_id": "1439",
"id": "2185",
"name": "Antoine Griezmann",
"substitution": "1",
"shirt_number": "7",
"photo": "https://cdn.worldcupapi.com/players/f/1/2/e/f12ee9734e1edf70ed02d9829018b3d9.png"
},
{
"team_id": "1439",
"id": "12034",
"name": "Aurélien Tchouaméni",
"substitution": "1",
"shirt_number": "8",
"photo": "https://cdn.worldcupapi.com/players/f/4/5/a/f45ab3a13b96528881ffe7a63b547e79.png"
},
{
"team_id": "1439",
"id": "12024",
"name": "Wissam Ben Yedder",
"substitution": "1",
"shirt_number": "9",
"photo": "https://cdn.worldcupapi.com/players/5/f/d/2/5fd2524092de9576f7341dc9aa5a53ae.png"
},
{
"team_id": "1439",
"id": "2368",
"name": "Kingsley Coman",
"substitution": "1",
"shirt_number": "11",
"photo": "https://cdn.worldcupapi.com/players/4/6/6/a/466accbac9a66b805ba50e42ad715740.png"
},
{
"team_id": "1439",
"id": "1305",
"name": "Jonathan Clauss",
"substitution": "1",
"shirt_number": "15",
"photo": "https://cdn.worldcupapi.com/players/f/d/5/c/fd5c905bcd8c3348ad1b35d7231ee2b1.png"
},
{
"team_id": "1439",
"id": "15655",
"name": "William Saliba",
"substitution": "1",
"shirt_number": "17",
"photo": "https://cdn.worldcupapi.com/players/1/2/8/4/128482b5773c09ed87e7630fd24d9e6f.png"
},
{
"team_id": "1439",
"id": "2352",
"name": "Moussa Diaby",
"substitution": "1",
"shirt_number": "20",
"photo": "https://cdn.worldcupapi.com/players/9/2/0/4/92049debbe566ca5782a3045cf300a3c.png"
},
{
"team_id": "1439",
"id": "196",
"name": "Théo Hernandez",
"substitution": "1",
"shirt_number": "22",
"photo": "https://cdn.worldcupapi.com/players/0/8/4/b/084b6fbb10729ed4da8c3d3f5a3ae7c9.png"
},
{
"team_id": "1439",
"id": "14978",
"name": "Alphonse Areola",
"substitution": "1",
"shirt_number": "23",
"photo": "https://cdn.worldcupapi.com/players/f/a/7/4/fa7410de86471342fc198f32104ccb31.png"
}
]
},
"away": {
"team": {
"id": "211",
"name": "Croatie"
},
"players": [
{
"team_id": "211",
"id": "29248",
"name": "Josip Stanisic",
"substitution": "0",
"shirt_number": "3",
"photo": "https://cdn.worldcupapi.com/players/2/3/5/3/235314dfab87978b63987f6695718b48.png"
},
{
"team_id": "211",
"id": "5330",
"name": "Josip Sutalo",
"substitution": "0",
"shirt_number": "6",
"photo": "https://cdn.worldcupapi.com/players/c/b/c/4/cbc462e27100dad71cdbf606d396ddad.png"
},
{
"team_id": "211",
"id": "20113",
"name": "Josip Brekalo",
"substitution": "0",
"shirt_number": "7",
"photo": "https://cdn.worldcupapi.com/players/1/0/5/b/105bbb4c5c3b35ce92f245193aa94883.png"
},
{
"team_id": "211",
"id": "4346",
"name": "Mateo Kovačić",
"substitution": "0",
"shirt_number": "8",
"photo": "https://cdn.worldcupapi.com/players/e/0/2/a/e02a35b1563d0db53486ec068ebab80f.png"
},
{
"team_id": "211",
"id": "14958",
"name": "Luka Modrić",
"substitution": "0",
"shirt_number": "10",
"photo": "https://cdn.worldcupapi.com/players/a/8/b/f/a8bfe36fa885d46814378912f268a8a1.png"
},
{
"team_id": "211",
"id": "9161",
"name": "Marcelo Brozović",
"substitution": "0",
"shirt_number": "11",
"photo": "https://cdn.worldcupapi.com/players/9/7/7/3/97737a7937a18cf131d9e21eda811113.png"
},
{
"team_id": "211",
"id": "1502",
"name": "Mario Pašalić",
"substitution": "0",
"shirt_number": "15",
"photo": "https://cdn.worldcupapi.com/players/7/7/f/9/77f959f119f4fb2321e9ce801e2f5163.png"
},
{
"team_id": "211",
"id": "11341",
"name": "Ante Budimir",
"substitution": "0",
"shirt_number": "17",
"photo": "https://cdn.worldcupapi.com/players/7/f/6/b/7f6b550688de8db0290009ba6abd673c.png"
},
{
"team_id": "211",
"id": "76121",
"name": "Martin Erlic",
"substitution": "0",
"shirt_number": "20",
"photo": "https://cdn.worldcupapi.com/players/a/9/b/1/a9b12572d82cef73f0d41c73e93c0249.png"
},
{
"team_id": "211",
"id": "8251",
"name": "Josip Juranović",
"substitution": "0",
"shirt_number": "22",
"photo": "https://cdn.worldcupapi.com/players/c/8/e/c/c8ecfaea0b7e3aa83b017a786d53b9e8.png"
},
{
"team_id": "211",
"id": "13448",
"name": "Ivica Ivušić",
"substitution": "0",
"shirt_number": "23",
"photo": "https://cdn.worldcupapi.com/players/7/7/d/a/77da2f07ed6c94afa27b5f113bea7ebe.png"
},
{
"team_id": "211",
"id": "5306",
"name": "Dominik Livaković",
"substitution": "1",
"shirt_number": "1",
"photo": "https://cdn.worldcupapi.com/players/5/e/8/a/5e8a5161de49c943dd66591511207f50.png"
},
{
"team_id": "211",
"id": "20129",
"name": "Marin Pongračić",
"substitution": "1",
"shirt_number": "2",
"photo": "https://cdn.worldcupapi.com/players/a/a/9/a/aa9a5147c8baff914423f5d1bfba879b.png"
},
{
"team_id": "211",
"id": "5320",
"name": "Lovro Majer",
"substitution": "1",
"shirt_number": "4",
"photo": "https://cdn.worldcupapi.com/players/3/a/2/a/3a2a9aef4cbed81244820a091667c0bd.png"
},
{
"team_id": "211",
"id": "11579",
"name": "Duje Ćaleta-Car",
"substitution": "1",
"shirt_number": "5",
"photo": "https://cdn.worldcupapi.com/players/5/e/f/2/5ef20b89bab8fed38253e98a12f26316.png"
},
{
"team_id": "211",
"id": "8816",
"name": "Andrej Kramaric",
"substitution": "1",
"shirt_number": "9",
"photo": "https://cdn.worldcupapi.com/players/0/0/7/2/007202387c4274c570d9cb72943fc873.png"
},
{
"team_id": "211",
"id": "74628",
"name": "Nediljko Labrovic",
"substitution": "1",
"shirt_number": "12",
"photo": "https://cdn.worldcupapi.com/players/9/8/7/1/9871706e617515257ecdad08ee863b46.png"
},
{
"team_id": "211",
"id": "4961",
"name": "Nikola Vlašić",
"substitution": "1",
"shirt_number": "13",
"photo": "https://cdn.worldcupapi.com/players/0/4/9/9/04992c5115a2c2fe6d12bdc21e16f64e.png"
},
{
"team_id": "211",
"id": "44535",
"name": "Luka Sucic",
"substitution": "1",
"shirt_number": "14",
"photo": "https://cdn.worldcupapi.com/players/d/6/0/6/d606046667548c7d7aedd977e9028e92.png"
},
{
"team_id": "211",
"id": "12739",
"name": "Kristijan Jakić",
"substitution": "1",
"shirt_number": "16",
"photo": "https://cdn.worldcupapi.com/players/5/9/7/0/597073e68fcefaa6bdf39ca6b399c28c.png"
},
{
"team_id": "211",
"id": "5315",
"name": "Mislav Oršić",
"substitution": "1",
"shirt_number": "18",
"photo": "https://cdn.worldcupapi.com/players/5/a/d/7/5ad742cd15633b26fdce1b80f7b39f7c.png"
},
{
"team_id": "211",
"id": "5327",
"name": "Luka Ivanušec",
"substitution": "1",
"shirt_number": "19",
"photo": "https://cdn.worldcupapi.com/players/d/6/9/3/d693d554e0ede0d75f7d2873b015f228.png"
},
{
"team_id": "211",
"id": "2566",
"name": "Domagoj Vida",
"substitution": "1",
"shirt_number": "21",
"photo": "https://cdn.worldcupapi.com/players/4/2/f/e/42fe880812925e520249e808937738d2.png"
}
]
}
}
Code Examples
JavaScript (Fetch)
const response = await fetch('https://api.worldcupapi.com/lineups?key=YOUR_API_KEY');
const data = await response.json();
console.log(data);
Python (Requests)
import requests
url = 'https://api.worldcupapi.com/lineups'
params = {'key': 'YOUR_API_KEY'}
response = requests.get(url, params=params)
data = response.json()
print(data)
PHP (cURL)
$url = 'https://api.worldcupapi.com/lineups?key=YOUR_API_KEY'; $ch = curl_init($url); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); $response = curl_exec($ch); curl_close($ch); $data = json_decode($response, true);
Java (HttpURLConnection)
URL url = new URL("https://api.worldcupapi.com/lineups?key=YOUR_API_KEY");
HttpURLConnection conn = (HttpURLConnection) url.openConnection();
conn.setRequestMethod("GET");
BufferedReader in = new BufferedReader(new InputStreamReader(conn.getInputStream()));
String response = in.readLine();
C# (HttpClient)
using (var client = new HttpClient())
{
var response = await client.GetAsync("https://api.worldcupapi.com/lineups?key=YOUR_API_KEY");
var content = await response.Content.ReadAsStringAsync();
var data = JsonSerializer.Deserialize<object>(content);
}
Go
import (
"encoding/json"
"net/http"
)
resp, err := http.Get("https://api.worldcupapi.com/lineups?key=YOUR_API_KEY")
if err != nil {
log.Fatal(err)
}
defer resp.Body.Close()
var data map[string]interface{}
json.NewDecoder(resp.Body).Decode(&data)
Ruby
require 'net/http'
require 'json'
uri = URI('https://api.worldcupapi.com/lineups?key=YOUR_API_KEY')
response = Net::HTTP.get_response(uri)
data = JSON.parse(response.body)