The world's easiest
UEFA Nations League API for developers ballers.

98 archived matches from the 2024/25 cycle, with team names, kickoff times, final scores, and half-by-half linescores where recorded. This is not the full cycle — see "Which editions does the archive cover?" below for what is and is not included.

Not yet. This is a results archive today — scores only. Odds, lineups, player stats, and a standings/group-table endpoint are not loaded for this competition.

Yes. The 2026/27 cycle is loaded and updating: 156 fixtures alongside the 98-match 2024/25 archive. Scores and head-to-head history are DB-backed reads with no upstream quota cost.

Every endpoint listed here reads from our Postgres archive, not an upstream provider. Hitting them does not consume any upstream provider credits or vendor allowance.

Yes for the match routes: GET /v1/matches and GET /v1/matches/:id are free, 1,000 req/day (2,000 with GitHub connected). Head-to-head, GET /v1/teams/:id/h2h-intelligence, is on the Solo plan.

Two cycles, and they are not alike. The 2026/27 cycle holds the COMPLETE GROUP PHASE: 156 fixtures, all four divisions, six matchdays each with no gaps (League A, B and C carry 8 fixtures per matchday, League D 2), 2026-09-24 to 2026-11-17 — with scores filling in as matches finish (27 finished as of 2026-09-27) and no odds attached yet. The 2027 knockout rounds are not scheduled yet and so are not listed. The 2024/25 cycle is an archive, and only part of it — the full cycle runs four divisions (League A, B, C, D — 54 teams, roughly 188 matches across all of them), and our 98 matches are not an even slice of that. League A (the top division) is the best-covered: its group phase (September–November 2024), knockout quarterfinals (March 2025), and Finals (June 2025) are all present, though even League A's group phase has a few gaps. League B's group phase is only partially archived. Of League C's four groups, exactly one (Sweden, Azerbaijan, Slovakia, Estonia) is archived — the other three are not. League D (the lowest division — teams like San Marino, Gibraltar, and Andorra) has no matches archived at all. In short: this is a partial, top-heavy cross-section of the 2024/25 cycle, not the full four-division competition.

Yes. GET /v1/teams/:id/h2h-intelligence?opponent_id=<team-uuid> returns results between two teams across every competition they have met in — not scoped to the Nations League alone, so a Portugal vs Spain query also pulls in any Euro or World Cup meetings between them.

Yes, for the 2026/27 cycle — it is loaded and updating. The complete 156-fixture group phase (2026-09-24 to 2026-11-17) is in the API, and finished matches carry scores. The 2024/25 cycle remains a closed archive beside it. Odds are not yet attached to 2026/27 fixtures. Cycles beyond 2026/27 are undetermined — not a confirmed roadmap item, not a promise.

Fixtures, scores, teams, match details, head-to-head history, and available odds are exposed through the connected soccer routes. Richer statistics and event panels render only when this competition has a measured, publishable source; an absent panel is not silently replaced with another league's data. Canonical match and national-team identifiers let a product move from schedule to detail without joining on display names.

Freshness depends on the dataset rather than one page-wide timer. Live scores and player statistics can refresh during matches, while fixtures, rosters, absences, and settled historical rows use slower cadences. Read the source date and response metadata before deciding how often your application should poll.

Create an account and API key, then send it as a Bearer token. Start with /v1/matches?sport=football&league=UEFA Nations League or /v1/standings?sport=football&league=UEFA Nations League so a healthy response is useful even when no match is live. Keep the returned canonical IDs for the detail calls that follow.

Discover identifiers from list responses instead of guessing them from names. UEFA Nations League match rows provide the national-team or match identity needed by detail routes. Preserve those IDs in your own records because accents, abbreviations, transfers, and reused display names make name joins unsafe.

The exact season range depends on the dataset and your plan. Use the coverage response and season labels returned by each route before promising a date range to users. Founder plans expose current-season evaluation on Free, up to five seasons on Solo and Trio, and all available history on Edge and Pro.

UEFA Nations League is organized by edition or competition cycle rather than a permanent domestic table. Retain the served edition and match status instead of manufacturing a domestic-style season from the kickoff year. Read match status to distinguish scheduled, live, finished, postponed, suspended, or cancelled fixtures. A table or archive and a future fixture window can legitimately carry different source timestamps.

This page does not claim a dedicated UEFA Nations League expected-goals leaderboard today. Match or player statistics appear only when the competition-specific source provides them and the publication checks pass. Treat an absent panel or missing field as unavailable, never as a measured zero or as permission to substitute another competition.

Soccer match events include goals, cards, substitutions, and event timing at scale. They are the soccer equivalent of play-by-play and belong to the Pro capability tier. Use the canonical match ID from the schedule or match list to request the event timeline.

An empty list can be a healthy response for a valid UEFA Nations League filter with no matching rows. A null field means the value was unavailable or redacted, and it should not be converted into zero. Check status, pagination, metadata, and the requested season before diagnosing a data gap.

A dedicated UEFA Nations League absence feed is not promised on this page today. Do not borrow an injury row from a domestic league or infer availability from a missing lineup. When competition-specific absences are added, they must carry their own source date and preserve the supplied injury, suspension, or other reason.

Your plan and response headers define the enforceable request limits. Poll live UEFA Nations League matches more frequently than schedules, rosters, or completed historical statistics. Back off on a 429 response instead of retrying at the same cadence.

Source corrections can change a completed match or player row after the final whistle. Keep canonical IDs so an updated value replaces the same record rather than creating a duplicate. Use the latest source date exposed by the response when auditability matters.

Commercial use depends on your plan and the applicable terms for the fields you use. API access does not itself grant redistribution, sublicensing, trademark, or media rights. Review the terms before shipping a public or customer-facing integration.

Match kickoff records use UTC timestamps. Convert them for display at the edge of your application while retaining the original value for sorting and comparisons. Keep the served tournament edition alongside the timestamp because national-team cycles do not map cleanly to a domestic season.

Read the returned match status rather than inferring state from a blank score or an old kickoff time. Preserve status values your application does not yet recognize so future vocabulary changes do not become false finals. Wait for a terminal status before triggering irreversible settlement or notification logic.