FOOTBALL DATA API DOCUMENTATION
Football API documentationFootball API serves the results, tables and fixtures of sixty leagues in thirty countries, the Champions League, Europa League and Conference League, and the World Cup and the Euros with their qualifiers. Every season goes back to 2015/16, or to the league's start where that is later, and results settle as each match ends.
Every answer is clean JSON with our own ids, the same shape in every league. People build match centres, club sites, prediction games, models that test an idea on a decade of results, and assistants that answer football questions from the data. Your complimentary key reads this season's Premier League; membership opens everything else, and live scores.
START HERE
Sign in with Google and your complimentary key is ready at once, shown once.
Get a free keySend it in the X-API-Key header to any endpoint, starting with yesterday's results.
GET https://api.footballapi.org/v1/results/yesterdayEVERY SUBJECT
Every match since 2015/16 or the league's start, found by competition, club, season or date: the score at every stage, goals and cards to the minute, each side's figures, positions before kickoff, the ground and the referee.
Read the matches and results guideEvery match still to come in the competitions your key reads, with kickoff in UTC and the local date, today's kickoffs and the ones that have moved.
Read the fixtures guideAny league table as it stood on any morning, every club's place before every match, and each season's clubs, matches and figures.
/v1/competitions/{competition}/seasons/{season}/table/v1/competitions/{competition}/seasons/{season}/positions/v1/competitions/{competition}/seasons/{season}/matches/v1/competitions/{competition}/seasons/{season}/stats
Every club with its ground: its matches, form, figures, runs, travel and every meeting with another club, and every ground in the collection.
/v1/clubs/v1/clubs/{club_id}/form/v1/clubs/{club_id}/stats/v1/clubs/{club_id}/head-to-head/{opponent_id}
The collection in figures: goals, scorelines, home advantage, half-time leads, kickoff times, referees and league positions, by competition and season.
Read the stats guideEvery match being played now with the minute and the events so far, refreshed every few seconds. Membership only.
Read the live scores guideEVERY ENDPOINT
/v1/competitionsEvery league and competition, and whether your key reads itCompetition/v1/competitions/{competition}A competition: its seasons and how many matchesCountries/v1/countriesEvery country with its competitions/v1/competitions/{competition}/seasons/{season}A season of a competition in figuresTable/v1/competitions/{competition}/seasons/{season}/tableThe table now, or on any morningPositions/v1/competitions/{competition}/seasons/{season}/positionsEvery club's place before every matchSeason clubs/v1/competitions/{competition}/seasons/{season}/clubsThe clubs of a season, with their groundsSeason matches/v1/competitions/{competition}/seasons/{season}/matchesEvery match of a season, in kickoff orderSeason stats/v1/competitions/{competition}/seasons/{season}/statsGoals, results and scorelines of a season/v1/matchesSearch every match by competition, club, season, date and moreMatch/v1/matches/{match_id}The score at every stage, positions before kickoff, the ground and the dayEvents/v1/matches/{match_id}/eventsEvery goal and card, to the minuteMatch stats/v1/matches/{match_id}/statsShots, possession, corners and cards, side by side/v1/resultsSettled matches by date, competition or club, newest firstToday/v1/results/todayEvery match settled today so farYesterday/v1/results/yesterdayEvery match settled yesterdayLatest/v1/results/latestThe most recent results, newest first/v1/fixturesMatches still to come, kickoff in UTCToday/v1/fixtures/todayEvery match kicking off todayRescheduled/v1/fixtures/rescheduledKickoffs that have moved/v1/liveEvery match being played now, with the minuteLive match/v1/live/{match_id}The score and events of a match being played/v1/clubsEvery club, by competition, season or countryClub/v1/clubs/{club_id}A club, its ground and where it isClub matches/v1/clubs/{club_id}/matchesEvery match of a club, by season, home or awayForm/v1/clubs/{club_id}/formThe last results of a club, with a summaryClub stats/v1/clubs/{club_id}/statsGoals, clean sheets and results, home and awayStreaks/v1/clubs/{club_id}/streaksCurrent and longest runsTravel/v1/clubs/{club_id}/travelHow far a club travels, and how it does at each distanceHead to head/v1/clubs/{club_id}/head-to-head/{opponent_id}Every meeting between two clubs/v1/groundsEvery ground, by country, surface or sizeGround/v1/grounds/{ground_id}A ground: its city, capacity and surface/v1/stats/goalsGoals a game, over and under, both sides scoringScorelines/v1/stats/scorelinesHow often each scoreline happensHome advantage/v1/stats/home-advantageHow often the home side winsHalf time/v1/stats/half-timeHow often a half-time lead holdsKickoff times/v1/stats/kickoffResults by kickoff time and weekdayReferee stats/v1/stats/refereesResults and cards by refereePositions and results/v1/stats/positionsHow the gap in the table tracks the resultPOPULAR CALLS
/v1/results/yesterday?competition=premier-league
The table this morning/v1/competitions/premier-league/seasons/2026/table
The weekend ahead/v1/fixtures?competition=premier-league
A club's form/v1/clubs/cl_a7vhnxhhh/form?last=5
Goals by season/v1/stats/goals?competition=premier-league&group_by=season
Your plan and calls/v1/usage
USE WITH CLAUDE AND AGENTS
Claude, ChatGPT, Cursor and other assistants can answer football questions straight from the data: add the MCP server and ask in plain words, and give an agent the skill so it knows how to use the API well. Download skill.md and save it as ~/.claude/skills/footballapi/SKILL.md, or upload it as a skill in Claude's settings.
Add it to Claude, ChatGPT, Cursor or Claude Code and ask in plain words; 13 tools, the same plans.
https://footballapi.org/mcpEvery tool, its parameters, the endpoint it calls and the plan it needs.
https://footballapi.org/documentation/mcp-toolsOne file that teaches an agent to use the API well; add it once.
https://footballapi.org/skill.mdThe whole API in one file, for agents that read; llms.txt points to it.
https://footballapi.org/documentation/manual.mdPLANS IN SHORT
- This season's Premier League
- 50 calls a day, reset at 00:00 UTC
- 10 calls a minute
- All 68 leagues and competitions, back to 2015/16
- Live scores
- 120 calls a minute, no daily ceiling
WHAT IS NEW
THE REST
QUESTIONS PEOPLE ASK
Every endpoint except live scores, for this season's Premier League, 50 times a day. Anything wider answers upgrade_required and names membership.
Every season from 2015/16, or from the league's start where that is later. /v1/competitions gives each league's first season.
Yes. A match or club keeps its id in every answer and for good, so you can store it.
UTC, written out with a Z. Matches also carry the local date of kickoff.