FIFA Intercontinental Cup API: Fixtures, Results & Match Data for Developers
Build with the FIFA Intercontinental Cup API: fixtures, results, lineups and match stats. Real endpoints and copy-paste code from GOAL API — confirm coverage, then build.
GOAL API
The FIFA Intercontinental Cup is football's newest global club competition — the continental champions meeting to crown a world club champion, with the December 2026 edition in Jeddah, Saudi Arabia. If you're adding it to a club-football tracker or a fan app, this guide shows how to pull its data from GOAL API with real, documented endpoints.
One upfront step saves you time: confirm the competition is covered and grab its league ID from the coverage page first. Everything after that is a standard league call.
Free tier, no credit card. Get a key and make your first request in a couple of minutes: goal-api.com/signup
What the Intercontinental Cup Is
It's an annual FIFA competition contested by the reigning champions of the continental confederations, culminating in a single final. It's a short, knockout-style event rather than a long league season — which shapes how you build for it (more on that below). The 2026 edition is hosted in Jeddah in December.
Step 1: Confirm Coverage & Get the League ID
Coverage depends on what GOAL API's upstream sources publish, and it's listed per competition. So before writing any code, open the coverage page and find the FIFA Intercontinental Cup. The page tells you two things you need:
- Whether the competition is covered, and exactly which data types are held for it (fixtures, standings, lineups, statistics, events).
- Its league ID — copy it; every call below uses it.
If you don't see it listed, contact the team to ask about coverage before you build the feature. Don't design around data a competition doesn't carry — that's the most common integration mistake.
Authentication
Send your API key in the X-API-Key header — grab it from the dashboard after signing up. Full auth details and every endpoint are in the GOAL API documentation.
Quick Start: Your First Request
With the league ID from the coverage page, fixtures are one call. (Replace {intercontinentalCupId} with the real ID.)
curl "https://goal-api.com/api/v1/leagues/{intercontinentalCupId}/fixtures" \
-H "X-API-Key: YOUR_API_KEY"
// JavaScript
const CUP = "{intercontinentalCupId}"; // from the coverage page
const res = await fetch(
`https://goal-api.com/api/v1/leagues/${CUP}/fixtures`,
{ headers: { 'X-API-Key': process.env.GOAL_API_KEY } }
);
const { data } = await res.json();Fixtures & Results
Fixtures and results are the backbone of any tournament view — the schedule plus finished-match scores. Each fixture carries the two teams, kickoff time in UTC, status, and (for finished matches) the score.
curl "https://goal-api.com/api/v1/leagues/{intercontinentalCupId}/fixtures" \
-H "X-API-Key: YOUR_API_KEY"Build on kickoffUtc and convert to your users' local time (the 2026 edition is in Saudi Arabia, but your audience may be anywhere). The generic pattern — find the competition, list fixtures, render them — is in the fixtures & standings page tutorial.
Lineups & Match Statistics
For a proper match-centre, pull the starting XI, formation, and bench for a fixture, plus stats like possession and shots. (Confirm on the coverage page that lineups and statistics are held for this competition before relying on them.)
# Lineups for a specific fixture
curl "https://goal-api.com/api/v1/fixtures/{fixtureId}/lineups" \
-H "X-API-Key: YOUR_API_KEY"# Match statistics
curl "https://goal-api.com/api/v1/fixtures/{fixtureId}/statistics" \
-H "X-API-Key: YOUR_API_KEY"Rendering a formation pitch and a stats panel is exactly what the build a match page tutorial walks through.
Goals, Cards & Substitutions
Event data — goals, cards, and substitutions — powers a match timeline or live event feed.
curl "https://goal-api.com/api/v1/fixtures/{fixtureId}/events" \
-H "X-API-Key: YOUR_API_KEY"Building for a Short Knockout Competition
Unlike a league season, the Intercontinental Cup is a handful of knockout matches over a short window. That changes your build in two ways:
- There's no long league table to render — build the bracket from the fixtures and their results rather than from a standings call. (If the coverage page shows standings for it, you can use them; otherwise drive the UI from fixtures.)
- All the action is compressed into a few days in December, so traffic spikes hard and briefly. Cache aggressively and lean on a plan sized for the spike — see the pricing note below.
Endpoints You'll Use
Generic, documented endpoints. Fill {intercontinentalCupId} from the coverage page; include only the data types the coverage page shows for this competition.
| Endpoint | Returns |
|---|---|
/api/v1/leagues/{id}/fixtures |
Fixtures & results |
/api/v1/leagues/{id}/standings |
Table (if the competition has one) |
/api/v1/fixtures/{id}/lineups |
Starting XI, formation, bench |
/api/v1/fixtures/{id}/statistics |
Possession, shots, match stats |
/api/v1/fixtures/{id}/events |
Goals, cards, substitutions |
Auth on every request: X-API-Key: YOUR_API_KEY. Full reference in the GOAL API documentation.
What to Build Next
A tournament match-centre — fixtures, live scores, lineups, and a stats panel for each tie as the competition plays out.
A bracket view — render the knockout path from the fixtures and results.
Size for the December spike — the whole competition lands in a few days, so traffic is bursty. The pricing per match guide shows how to size for that. Covering more competitions? Browse the all leagues coverage, or see the Premier League API guide and UEFA Nations League API guide for the same pattern on other competitions.
FAQ
Does GOAL API cover the FIFA Intercontinental Cup? GOAL API covers 1,000+ competitions and lists exactly what it holds per competition. Check the coverage page to confirm and to copy the league ID.
How do I get the fixtures? With the league ID from the coverage page: GET /api/v1/leagues/{id}/fixtures with your API key.
Is it free? Any competition GOAL API covers is on the free tier — no credit card.
Start building free → goal-api.com/signup | No credit card | Confirm the competition on the coverage page
