Description
Get all scheduled World Cup matches. You can optionally filter by date to get matches for a specific day. Returns match details including teams, scheduled time, and venue information.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
key |
string | Yes | Your API key for authentication |
date |
string | No | Filter by date in YYYY-MM-DD format |
lang |
string | No | Language code (es, fr, de, etc.) - defaults to English |
page |
integer | No | Page number (default: 1) |
team_id |
integer | No | The team ID |
group |
string | No | Filter by specific group (A, B, C, etc.) |
Example Request
GET /fixtures?key=YOUR_API_KEY
Example Response
[
{
"group_id": 4286,
"id": 1825339,
"date": "2026-06-11",
"location": "Estadio Azteca, Mexico City",
"away": {
"id": 2767,
"logo": "https://cdn.worldcupapi.com/teams/2450fc92a007f6a1147cc6d294b7e730.png",
"name": "South Africa"
},
"odds": {
"pre": {
"1": null,
"2": null,
"X": null
}
},
"home": {
"id": 1450,
"logo": "https://cdn.worldcupapi.com/teams/ccdd284616580f9c93ebe29167f51be1.png",
"name": "Mexico"
},
"time": "19:00:00",
"round": "1"
},
{
"group_id": 4286,
"id": 1825377,
"date": "2026-06-25",
"location": "Estadio BBVA, Guadalupe",
"away": {
"id": 1452,
"logo": "https://cdn.worldcupapi.com/teams/eb0a8518fe001e28e044e8812d4c9822.png",
"name": "South Korea"
},
"odds": {
"pre": {
"1": null,
"2": null,
"X": null
}
},
"home": {
"id": 2767,
"logo": "https://cdn.worldcupapi.com/teams/2450fc92a007f6a1147cc6d294b7e730.png",
"name": "South Africa"
},
"time": "01:00:00",
"round": "3"
}
]
Code Examples
JavaScript (Fetch)
const response = await fetch('https://api.worldcupapi.com/fixtures?key=YOUR_API_KEY');
const data = await response.json();
console.log(data);
Python (Requests)
import requests
url = 'https://api.worldcupapi.com/fixtures'
params = {'key': 'YOUR_API_KEY'}
response = requests.get(url, params=params)
data = response.json()
print(data)
PHP (cURL)
$url = 'https://api.worldcupapi.com/fixtures?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/fixtures?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/fixtures?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/fixtures?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/fixtures?key=YOUR_API_KEY')
response = Net::HTTP.get_response(uri)
data = JSON.parse(response.body)