FOOTBALL FIXTURES DATA

Every match still to come in the competitions your key reads, soonest first, today's kickoffs and the ones that have moved.

THE FIXTURES AHEAD

/v1/fixtures gives the matches still to come in the competitions your key reads, soonest first. date_from and date_to keep to a window, such as one weekend. /v1/fixtures/today gives today's kickoffs.

curl "https://api.footballapi.org/v1/fixtures?competition=premier-league" \
  -H "X-API-Key: your key"

import requests

r = requests.get(
    "https://api.footballapi.org/v1/fixtures?competition=premier-league",
    headers={"X-API-Key": "your key"},
)
print(r.json()["data"])

const res = await fetch("https://api.footballapi.org/v1/fixtures?competition=premier-league", {
  headers: { "X-API-Key": "your key" },
});
const { data } = await res.json();
console.log(data);

$ch = curl_init("https://api.footballapi.org/v1/fixtures?competition=premier-league");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["X-API-Key: your key"],
]);
$data = json_decode(curl_exec($ch), true)["data"];
print_r($data);

MOVED KICKOFFS

/v1/fixtures/rescheduled lists the matches whose kickoff has moved in the days you ask about, so a calendar can be kept right.

TIMES

kickoff_utc is kickoff in UTC; kickoff_local_date is the day where the match is played, which can differ for an evening kickoff far from London.

FROM FIXTURE TO RESULT

A fixture keeps its match_id when it is played, so the same id finds it in /v1/live while it is on and in /v1/results once it ends. The lists are refreshed at least every 15 minutes.