Football Data API

Search football names for typed suggestions and usable team or event identifiers, with a successful empty-result state. Pass required search text, such as Real Madrid. Observed JSON contains status='success' and response.suggestions. Team suggestions include type, id, name, leagueId and leagueName; match suggestions include id, matchDate, status.utcTime, started/finished/cancelled flags and home/away IDs and names. Fields differ by result type. The suggestion score is a search-ranking value, not a match score. An unmatched query returned suggestions=[].

Look up club names through a team-focused search operation before requesting team profiles, squads or transfer records. Requires search text. Use returned team identifiers only after inspecting the payload and disambiguating similarly named clubs. This operation has no verified response sample; the general search response does not establish the exact team-search field names, ordering or empty-result format.

Find football event candidates by search text before choosing a match-detail, score or statistics request. Requires search. Select a returned event by its actual teams and kickoff context when those fields are available. The match-specific search payload has not been verified; do not assume it shares the general search schema or that club names alone identify a unique match.

Find competition candidates by name and validate a league identifier for details, fixture lists or standings. Requires search text. Inspect this operation's response for league identities and disambiguating context before reuse. Its field names and no-result behaviour have not been verified. A discoverable competition is not proof that every related statistics or standings operation supports it.

Find player candidates by name and verify player identifiers before opening profiles, images or player news. Requires search. Preserve any returned identity context to distinguish namesakes, then pass a confirmed player ID to a player-specific operation. No player-search response sample has been verified, so exact fields, pagination and empty-result semantics are not established.

Read a football match-day list with event IDs, team scores, UTC kickoff timestamps and started/finished flags using a YYYYMMDD date. Pass required date, for example the observed 20261008. response.matches contains id, leagueId, home/away objects with id, name, longName and score, plus statusId, tournamentStage, status.utcTime, started, finished, cancelled and timeTS. Finished examples also include status.scoreStr and status.reason. A date response spanned two UTC dates; the calendar timezone is not established. Convert UTC timestamps and filter the intended local day client-side. A 0-0 score with started=false is not a finished draw.

Request the date-based league-match listing with a YYYYMMDD value for inspection as a competition-oriented daily schedule. Requires date only. Despite the operation's purpose, no leagueid or timezone input is declared; do not add either to the request. No response sample has been verified for this variant. Inspect its actual nesting, event identifiers and coverage before treating it as a league-grouped equivalent of the verified date list.

Request a league-scoped match listing using a league ID to investigate fixtures, results and the available date range. Requires leagueid. No season, date, round or page parameter is declared for this operation. Its response has not been verified; inspect match identifiers, actual date span and status fields before building an archive. The listing name does not establish unlimited historical coverage or support for every league.

Resolve an event ID into match identity, home and away teams, competition information, UTC kickoff and completion flags. Pass required eventid from match search or a fixture list. The verified event 5868072 returns status='success' and response.detail with matchId, matchName, matchRound, leagueId, leagueName, leagueRoundName, parentLeagueId, countryCode, homeTeam, awayTeam, matchTimeUTCDate, started and finished. teamColors and coverageLevel were also present. The observed derby was finished; coverageLevel='xG' is a coverage label, not an xG measurement. This detail response did not include the final score.

Request the score read for one event ID as a candidate source for an individual match's score component. Requires eventid from a fixture or search result. The score response has not been verified, so its exact keys and treatment of scheduled games, extra time or penalties are unknown. Validate score semantics against match status before showing a result; this GET does not establish update frequency or push notifications.

Request the status read for one event ID to inspect the match states available for application-owned refresh logic. Requires eventid. No response sample has been verified for this status-specific operation. Validate its actual state fields independently of the started and finished flags seen in match details. Handle unknown, missing and cancelled states explicitly rather than assuming a fixed enumeration or guaranteed live delivery.

Request head-to-head information for the two participants associated with a selected football event. Requires eventid, not separate home and away team IDs. No head-to-head response sample has been verified. Check the returned meetings, date span and match identifiers before summarizing a rivalry; returned records do not establish a complete history or a prediction of the next result.

Request the home-side lineup for an event to evaluate available player records independently of the away side. Requires eventid. No home-lineup payload has been verified, so formations, starters, substitutes and player fields are not guaranteed. Inspect returned roles and identifiers before rendering a lineup or joining it to a roster. Missing lineup data must not be presented as a team having no players.

Request the visiting team's lineup for a football event before building the away side of a match panel. Requires eventid. This lineup variant has no verified response sample. Inspect usable player IDs, roles and any formation data instead of assuming the away response mirrors the home schema. Distinguish unavailable coverage from a genuinely empty returned list; lineup publication timing is not established.

Request location information for one football event as a candidate source for a match-specific venue card. Requires eventid. The venue response has not been verified; stadium names, addresses and coordinates must be confirmed from the actual payload. A club's usual stadium is not proof of a particular event's location, and missing coordinates should not be replaced with guessed positions.

Request referee information associated with a football event for a match fact sheet or event-assignment dataset. Requires eventid. No referee response sample has been verified; confirm whether usable names, identifiers or assignment details are returned. This operation does not establish officiating history, disciplinary statistics, assignment certainty or support for every competition.

Request highlight information for a selected event and inspect whether usable post-match media metadata or links are available. Requires eventid. The highlights payload has not been verified, and this operation does not establish live streams, downloadable video or media rights. Inspect returned content, distinguish unavailable highlights from request failures, and verify usage permissions before embedding or caching any media.

Read a league table with team identifiers, played matches, wins, draws, losses, goals, goal difference, points and returned positions. Pass required leagueid; 47 produced a 20-team Premier League table. response.standing rows include id, name, shortName, played, wins, draws, losses, scoresStr, goalConDiff, pts and idx. deduction, ongoing and qualColor were also present and can be null. Keep idx and returned order rather than inventing tie-break rules. No season parameter is declared. The sample's games and points reconciled; competition scoring and deduction rules still need checking before applying arithmetic universally.

Request a league's home-record standings to evaluate a venue-specific companion to the overall competition table. Requires leagueid. This home-split response has not been verified; do not assume it duplicates the overall table's fields, ranking rules or season scope. Inspect the metrics and ordering before displaying home performance, and label the view as a home split rather than an overall league rank.

Request a league's away-record standings for a visiting-performance view separate from the overall competition table. Requires leagueid. No away-standings response sample has been verified. Confirm the actual metrics, ordering and scope before comparing teams. The operation declares no season input, and an away-only position should not be used as a team's overall league ranking.

Request a league-scoped goals-leader listing as a candidate source for a football top-scorers page. Requires leagueid. The response has not been verified; confirm player IDs, goal totals, ranking and the period actually covered before publication. No season selector or all-time filter is declared. A listing alone does not establish penalty splits, minutes played or fantasy points.

Request an assists-focused player listing for a league and inspect its suitability for a creative-player leaderboard. Requires leagueid. No assists-leader response sample has been verified. Confirm the player identities, assist metric, ranking and time scope before comparison. Do not infer expected assists, chance creation, all-time records or player quality from the operation name.

Request a rating-focused player listing for one league and validate the source's rating semantics before ranking players. Requires leagueid. No rating-leader payload has been verified. Inspect returned ratings, ordering, player IDs and any sample-size context; rating scale, eligibility and calculation are not established. Do not equate this listing with fantasy points or ratings from another system.

Resolve a team ID into a club profile with identity, country, latest season, primary league and structured stadium information. Pass required teamid; the observed 8633 resolves to Real Madrid. status='success' wraps response.details with id, type, name, shortName, country, gender, latestSeason, primaryLeagueId, primaryLeagueName and teamColor. sportsTeamJSONLD.location includes stadium name, address and coordinates in the sample; faqJSONLD contains dated next-match and stadium answers. Treat those answers as snapshots, not a guaranteed current fixture feed. athlete was empty, so use the separate squad operation rather than assuming this profile contains players.

Request a team-scoped player listing to inspect squad identities for roster pages and downstream player lookups. Requires teamid. The squad payload has not been verified, so player fields, role grouping and roster completeness must be checked. The team-detail sample contained an empty athlete array and does not establish this operation's schema. Treat roster differences as review signals, not automatic proof of transfers.

Request badge information for a team ID and verify its response format before adding club imagery to football components. Requires teamid. No team-logo response sample has been verified; do not assume a direct image rather than JSON metadata. Check the content type, available asset references and usage permissions before embedding or caching. Missing badges should retain an accessible team-name fallback.

Request a league-scoped team listing to evaluate a competition directory and discover club identifiers for team lookups. Requires leagueid. No league-team directory sample has been verified, so team fields, membership period and completeness remain unconfirmed. Inspect usable IDs and actual scope before describing this as every current club in a competition. This listing is separate from the home- and away-team variants and is not an established standings response.

Request the home-team listing for a league and inspect its actual scope before offering a home-side selection view. Requires leagueid. No home-team listing response has been verified. Confirm identifiers, grouping and membership semantics before using it in a fixture tool; the operation name does not establish a unique club set, a complete roster or home standings. Compare it with the all-team and away-team reads rather than assuming their meanings are interchangeable.

Request the away-team listing for a league and validate its interpretation before building a visiting-team selection view. Requires leagueid. This away-team listing has no verified response sample. Inspect record identities, nesting and actual scope before use. The catalogue label is not proof of a separate club membership set or an away-performance table. Evaluate differences from the home and all-team listings using returned data rather than endpoint names alone.

Resolve a player identifier through the player-detail operation for a profile assembled from fields the response actually supplies. Requires playerid from player search or a validated squad. The catalogue supplies 671529 as an example input, but no player-detail payload has been verified. Confirm identity and available attributes before display; do not assume career history, injury status, valuation or biographical fields from the endpoint name.

Request player-image information by player ID and inspect the returned representation before displaying a headshot. Requires playerid. No image response sample has been verified, so the operation may not return a directly embeddable image or the same format as team logos. Validate usable content and permissions before rendering or caching, and keep a player-name fallback for missing assets.

Request the football country directory to evaluate country navigation and code references for competition discovery. This GET takes no operation parameters. No country-directory response has been verified; inspect its names, codes and grouping before building a selector. Do not assume codes use a particular standard or can be passed unchanged to the odds operation, whose documented examples use BR and UK.

Request the country-associated competition listing to inspect available league-country relationships for navigation and labeling. This GET takes no operation parameters. Its response has not been verified; exact grouping, identifiers and domestic-league coverage remain unknown. Check the records before using this as a directory, and do not infer complete competition or detailed-data coverage from its catalogue label.

Request the popular-league selection as a candidate seed for first-run competition discovery. This GET has no operation parameters. The response and ordering have not been verified. Inspect usable competition identities before rendering shortcuts, and describe the result as a returned selection rather than an independently measured global popularity ranking or a complete league catalogue.

Resolve a league identifier through the competition-detail operation before labeling related fixture and table requests. Requires leagueid. No league-detail response sample has been verified; confirm its identity, descriptive attributes and available context before creating a landing page. The operation declares no season or country filter, and a valid league identity does not guarantee every related endpoint has data for it.

Request logo information for a league ID and verify the representation before displaying a competition badge. Requires leagueid. The league-logo payload has not been verified; inspect whether the response is image content or metadata and whether usable assets are returned. Check image-use permissions before caching or redistribution, and retain the competition name if a badge is unavailable.

Request the season directory to inspect available season strings before using an operation that explicitly accepts a season. This GET takes no leagueid or other operation input. Its response has not been verified; check the actual season values and ordering before building a selector. A global season listing does not establish that every competition supports every season, nor does it add season filters to other endpoints.

Request the rounds listing for a league to discover usable round identifiers and labels before a round-detail lookup. Requires leagueid. No rounds-list response sample has been verified. Inspect round identities, labels and ordering before offering a matchweek selector; a displayed round number is not established as a globally valid roundid. No season parameter is declared.

Request one round's detail using an identifier discovered from a league's rounds listing. Requires roundid; no leagueid, season or date parameter is declared. The response has not been verified, and the catalogue example '1' is not proof of a globally valid round identifier. Inspect identity and grouping before caching a round across competitions; obtain a real ID from the preceding rounds-list read.

Request league-scoped round-player information and inspect its grouping before using it in a matchweek player feature. Requires leagueid only; no roundid or season parameter is declared. The response has not been verified. Confirm which round context, player identities and ordering are supplied before labeling entries as selections, rankings or performance records. Do not claim team-of-the-week or fantasy-point semantics without evidence.

Request a league's season-oriented trophy listing as a candidate index for competition honours pages. Requires leagueid. The honours-history response has not been verified; inspect seasons, trophy records and any returned identifiers before building an index. The listing does not establish an exhaustive all-time archive. Check usable season values before requesting the separate season-specific trophy detail operation.

Request trophy details using both a league identifier and an explicit season value for a season-specific honours view. Requires leagueid and season. The catalogue example uses season='2023/2024'; confirm a supported value from validated season or honours data rather than assuming every combination works. No response sample has been verified. Display winners, titles and other attributes only if the actual response supplies them.

Request the match-statistics variant for one event and inspect its metrics before selecting a statistics source. Requires eventid. No response sample has been verified for this variant, so exact metrics, units and period coverage are unknown. It is a distinct catalogue read from the event-statistics variant; do not assume their schemas or values are identical. Preserve the operation identity with raw snapshots used for analysis.

Request the event-statistics variant for a selected match and inspect the available team metrics and their units. Requires eventid. No payload has been verified for this event-statistics read. Validate actual metric names, team associations and period scope before rendering a statistics section. This is a separate operation from match statistics; a similar name does not establish identical content or a safe automatic fallback.

Request the first-half event-statistics variant for a match and validate the period and available metrics before analysis. Requires eventid. This first-half event-statistics payload has not been verified. Check metric names, units and whether the half is complete before producing a half-time summary. It is separate from the match first-half statistics variant and must not be assumed to share its schema.

Request the second-half event-statistics variant for a match to inspect period-specific data independently of first-half values. Requires eventid. No response sample has been verified. Validate second-half period semantics, metric units and any extra-time treatment before comparison. Full-match totals cannot be assumed to equal a simple sum of half responses, particularly for percentages, averages or differently scoped measures.

Request the match-statistics family's first-half variant as a separate candidate source for period-specific match reporting. Requires eventid. No response sample has been verified for this variant. Inspect the returned period, fields and units before using it in a report, and compare it with the separately listed first-half event-statistics operation before selecting a parser or implementing a fallback.

Request the match-statistics family's second-half variant for inspection as a source of second-period report data. Requires eventid. No payload has been verified for this operation. Establish period semantics, field coverage and metric units independently of the event second-half statistics read. Keep this variant's provenance and avoid merging overlapping or conflicting metrics without explicit compatibility checks.

Request a page of the general football transfer listing to evaluate a resumable transfer-discovery workflow. Requires page; the catalogue example is '1'. No transfer response has been verified, so page size, total counts, record fields and completion statuses are unknown. Inspect actual pagination behaviour and preserve validated identifiers for deduplication. A listed move must not be labeled completed unless returned status information supports it.

Request a page of the top-transfer selection for a featured-transfer digest after validating its actual selection semantics. Requires page. No response sample has been verified; inspect record fields, pagination and ordering before presenting a featured list. The operation name does not establish a transfer-fee ranking, most-expensive ordering or completed-transfer status. Keep this selection distinct from the market-value transfer listing.

Request a page of the market-value transfer selection and inspect how valuation is represented before comparing records. Requires page. No market-value payload has been verified. Confirm valuation fields, currency, dates, selection order and transfer statuses from actual responses. Market value and paid transfer fee are different concepts; neither a highest-fee ranking nor a valuation method is established by this operation name.

Request a competition-scoped transfer listing to evaluate league-specific transfer tracking and editorial research. Requires leagueid. No league-transfer response has been verified, and no page, season or transfer-window parameter is declared. Confirm record scope, dates, identities and statuses before counting moves. This league view must not be assumed to cover every transaction in a window.

Request a club's incoming-transfer listing to evaluate an arrivals view kept separate from the current squad. Requires teamid. No incoming-transfer sample has been verified; inspect identities, dates, loan or permanent-move indicators and actual statuses before labeling arrivals. A listed incoming move is not automatically a current squad member or a completed signing.

Request a club's outgoing-transfer listing to evaluate a departures page using the returned move statuses and dates. Requires teamid. No departure payload has been verified. Confirm identity, timing and move type before describing a record as a completed permanent departure. Do not automatically remove a player from a squad or infer termination merely because an outgoing record appears.

Request a club's contract-extension listing to evaluate a renewals section distinct from incoming and outgoing transfers. Requires teamid. No extension response sample has been verified. Confirm player identities, effective dates, contract terms and statuses from the actual payload before publication. Renewal records should not be counted as new arrivals, and no negotiation or contract-management capability is established.

Request the trending football news selection to evaluate a discovery feed built from returned story metadata and permitted links. This GET takes no operation parameters. No trending-news response has been verified; inspect actual story fields, source references and ordering. Trend methodology, freshness guarantees and full-article availability are not established. Content references do not grant permission to republish articles.

Request a page of team-associated news for a club reading list linked to a validated team identity. Requires teamid and page. No team-news response sample has been verified. Confirm story metadata, team relevance, source links and page behaviour before publication; a team-associated feed is not proof of exclusive coverage or article-republication rights. The operation declares no language filter.

Request a page of league-associated news to evaluate a competition reading hub with validated source references. Requires leagueid and page. No league-news payload has been verified; inspect metadata, competition relevance, pagination and actual article links before rendering. Do not infer full-text availability, a fixed page size or a guaranteed publication schedule. Reuse of article content requires appropriate permission.

Request a page of player-associated news using a genuine player identifier discovered from player search or a squad. Requires playerid and page. Obtain a validated player ID first; a club ID is not a substitute. No player-news sample has been verified, so exact metadata, relevance and pagination remain unknown. Keep source links and verify content permissions before reuse; do not assume that every story uniquely identifies a namesake.

Request odds for a football event and a country code, then validate market availability and returned price semantics. Requires eventid and countrycode; documented country examples are BR and UK. No odds response has been verified, so bookmaker fields, market types, numeric formats and availability are not established. Check accepted country values for your target use. This read does not place bets, generate predictions or guarantee profitability.

Request match-poll information for an event as a read-only companion to a preview or fan-engagement page. Requires eventid. No poll response sample has been verified; inspect poll metadata and available context before rendering. This GET does not establish a voting or submission capability. Keep fan sentiment separate from bookmaker odds, calibrated probabilities and guaranteed match predictions.

Request fan-vote results for a football event and inspect any returned aggregates before describing community sentiment. Requires eventid. No vote-result response has been verified, so counts, percentages, outcome labels and sample size are unknown. Confirm actual fields before rendering results and keep timestamps with snapshots. Fan votes are community opinion, not bookmaker prices, calibrated win probabilities or a reliable prediction.