29 published REST services
The football data services behind your product.
Explore documented GET endpoints under /api/v1/football/: JSON football feeds and authenticated image-payload lookups. Start with the collection your product needs, then connect related services using the supplied identifiers. Each page explains the real path, inputs and plan requirements.
Starter EUR 29, Growth EUR 99, Pro EUR 249 a month. No free trial.
Start here
Fixtures are the spine of almost every product.
Schedules give you the match identifiers that scores, statistics and previews join on. Request a competition's fixtures by leagueId, store them by ID, and build outwards.
GET /api/v1/football/fixtures?leagueId=1204
Read the fixtures guideFixtures & competitions
Schedules, competition identifiers and the season values every historical request needs.
- Endpoint documentation
Football fixtures API
/api/v1/football/fixtures?leagueId=
Discover season fixtures and keep schedules joined on stable match identifiers.
All plansDetails - Endpoint documentation
Upcoming football matches API
/api/v1/football/upcoming?offset=
Build an upcoming-match view without treating a schedule as a confirmed final result.
All plansDetails - Endpoint documentation
Football competitions API
/api/v1/football/competitions
Discover competition identifiers before requesting league-scoped football data.
Growth and ProDetails - Endpoint documentation
Football seasons API
/api/v1/football/seasons
Find the season values used by historical fixture, statistics and table requests.
Growth and ProDetails - Endpoint documentation
Historical football fixtures API
/api/v1/football/historical-fixtures?leagueId=&season=
Retrieve supplied past-season fixtures and results with their original identifiers.
All plansDetails
Scores & results
Polled REST snapshots of match state, from live play to last week's results.
- Endpoint documentation
Football scores and results API
/api/v1/football/scores
Build a score centre from supplied match groups, statuses and results.
All plansDetails - Endpoint documentation
Alternative football scores API
/api/v1/football/scores-new
Integrate the separately documented scores service without assuming identical envelopes.
All plansDetails - Endpoint documentation
Live football scores API
/api/v1/football/live
Poll currently live matches through REST and make refresh times clear to readers.
All plansDetails - Endpoint documentation
Recent football results API
/api/v1/football/recent-results?offset=
Publish recent results while preserving match states, corrections and competition context.
All plansDetails
Statistics & squads
Match statistics, squads, predicted line-ups, injuries and head-to-head context.
- Endpoint documentation
Football match statistics API
/api/v1/football/match-statistics?leagueId=
Explore supplied competition match statistics and join them to fixture identifiers.
All plansDetails - Endpoint documentation
Historical football statistics API
/api/v1/football/historical-statistics?leagueId=&date=
Build a season-aware archive from supplied historical match statistics.
All plansDetails - Endpoint documentation
Single-match football statistics API
/api/v1/football/match?id=&league=
Request a focused match record using the identifiers required by the public contract.
Growth and ProDetails - Endpoint documentation
Football squads API
/api/v1/football/squads?leagueId=
Organise supplied competition squads without confusing membership with a confirmed line-up.
All plansDetails - Endpoint documentation
Predicted football line-ups API
/api/v1/football/predicted-lineups?leagueId=
Display projected team selections with an explicit prediction label and refresh context.
All plansDetails - Endpoint documentation
Football injuries API
/api/v1/football/injuries
Add supplied injury information without inferring fitness, diagnoses or return dates.
Growth and ProDetails - Endpoint documentation
Football head-to-head API
/api/v1/football/head-to-head?team1Id=&team2Id=
Compare supplied historical meetings between two teams without presenting them as predictions.
Growth and ProDetails
Standings
Current and past-season tables, rendered as the source publishes them.
- Endpoint documentation
Football standings API
/api/v1/football/standings?leagueId=
Render current league tables, including the groups and phases supplied by the response.
All plansDetails - Endpoint documentation
Historical football standings API
/api/v1/football/historical-standings?leagueId=&season=
Request past-season tables with explicit competition and season context.
All plansDetails
Player leaderboards
Scorers, assists and cards per competition, in supplied order with ties kept.
- Endpoint documentation
Football top scorers API
/api/v1/football/scorers?leagueId=
Build a competition scoring leaderboard while preserving supplied rankings and ties.
All plansDetails - Endpoint documentation
Football assist leaders API
/api/v1/football/assists?leagueId=
Show competition assist leaders without substituting inferred or differently defined metrics.
All plansDetails - Endpoint documentation
Football cards leaders API
/api/v1/football/cards?leagueId=
Display supplied disciplinary leaderboards with clear competition and metric labels.
All plansDetails
Team & player profiles
Identity pages for clubs and players, built on string identifiers.
- Endpoint documentation
Football team profiles API
/api/v1/football/team?teamId=
Build team identity pages around supplied team identifiers and available profile fields.
Growth and ProDetails - Endpoint documentation
Football player profiles API
/api/v1/football/player?playerId=
Retrieve player profiles without treating missing biography fields as verified facts.
Growth and ProDetails
Identifiers & updates
Short codes, change hints and identifier mapping for keeping records tidy.
- Endpoint documentation
Football team abbreviations API
/api/v1/football/abbreviations
Use supplied short team labels for displays, never as replacements for canonical IDs.
Growth and ProDetails - Endpoint documentation
Updated football team IDs API
/api/v1/football/updated-teams
Use the supplied updated-team identifier feed as an enrichment hint, not a complete change log.
Growth and ProDetails - Endpoint documentation
Updated football player IDs API
/api/v1/football/updated-players
Refresh relevant player records from supplied updated identifiers without assuming webhook delivery.
Growth and ProDetails - Endpoint documentation
Football in-play ID mapping API
/api/v1/football/inplay-mapping
Reconcile supplied in-play and football identifiers without implying ball-tracker activation.
Growth and ProDetails
Football images
Team crests and player portraits as PNGs, fetched server-side.
- Endpoint documentation
Football team crests API
/api/v1/football/team-images?teamId=
Retrieve supplied team crest image payloads in an authenticated JSON response, then validate and decode them server-side.
Growth and ProDetails - Endpoint documentation
Football player images API
/api/v1/football/player-images?playerId=
Look up available player portrait payloads by identifier and keep image decoding, caching and credentials server-side.
Growth and ProDetails
Outside the REST catalogue
MCP for AI assistants
Connect an AI assistant to published football data through MCP. The guide explains setup and limits.
Ball tracker
A separate product area with its own activation. Not part of any data plan, and not enabled by the in-play mapping service.
Football odds
Not currently available. No odds endpoint is published; read what that means for your plans.
One key reaches every service your plan includes.
Starter covers five saved leagues with 5,000 successful requests per UTC day. Growth and Pro add all available leagues and the profile, identifier and image services. Failed and denied requests are never billed.