A full FIFA World Cup 2026 sandbox spanning the USA, Canada and Mexico: browse the 48-team format, compute live group standings, simulate matches with goal events, chase the Golden Boot, buy limited tickets (409 when sold out) and submit champion predictions.
The World Cup 2026 API is the largest in the catalog — teams, groups, venues across the host cities, squads, match simulation, ticket sales and bracket predictions. Tickets are limited and matches must be played in group order, so it combines contended writes, business-rule validation and a slow simulation endpoint in one surface. It is the closest thing here to a full application backend.
Base URL: https://funapi.dev/api/worldcup/v1 · 17 endpoints · OpenAPI 3.1 spec and Postman collection available. New here? Read the getting started guide.
GET https://funapi.dev/api/worldcup/v1/teams — List qualified teams (filter by group, confederation or hosts). No token, no signup:
curl -i https://funapi.dev/api/worldcup/v1/teams
answers 200 OK with:
{
"total": 48,
"data": [
{
"id": 1,
"name": "United States",
"code": "USA",
"group": "A",
"confederation": "CONCACAF",
"fifaRank": 17,
"host": true
},
{
"id": 2,
"name": "Wales",
"code": "WAL",
"group": "A",
"confederation": "UEFA",
"fifaRank": 41,
"host": false
},
{
"id": 3,
"name": "Ghana",
"code": "GHA",
"group": "A",
"confederation": "CAF",
"fifaRank": 42,
"host": false
},
{
"id": 4,
"name": "Uzbekistan",
"code": "UZB",
"group": "A",
"confederation": "AFC",
"fifaRank": 48,
"host": false
},
{
"id": 5,
"name": "Mexico",
"code": "MEX",
"group": "B",
"confederation": "CONCACAF",
"fifaRank": 15,
"host": true
},
{
"id": 6,
"name": "Türkiye",
"code": "TUR",
"group": "B",
"confederation": "UEFA",
"fifaRank": 28,
"host": false
},
{
"id": 7,
"name": "Senegal",
(truncated — the full response comes back when you run it)
national squads and groups
GET /worldcup/v1/teams — List qualified teams (filter by group, confederation or hosts) · Responds with 200 400 Link to this endpointGET /worldcup/v1/teams/{id} — Get one national team · Responds with 200 404 Link to this endpointGET /worldcup/v1/groups/{letter}/standings — Live group standings computed from finished matches · Responds with 200 400 404 Link to this endpointfixtures, simulation and VAR
GET /worldcup/v1/matches — List fixtures (filter by stage, status, group or team) · Responds with 200 400 Link to this endpointGET /worldcup/v1/matches/{id} — Get one fixture with team and venue details · Responds with 200 404 Link to this endpointPOST /worldcup/v1/matches/{id}/simulate — Kick off and simulate a match — updates score, goal events and standings (admin only) (requires Bearer auth) · Responds with 200 404 409 422 Link to this endpointGET /worldcup/v1/matches/{id}/events — Goal timeline of a played match (409 before kickoff) · Responds with 200 404 409 Link to this endpointGET /worldcup/v1/matches/{id}/var-review — Request a VAR review — the check takes ~3 seconds · Responds with 200 404 Link to this endpoint2026 host stadiums
GET /worldcup/v1/venues — List 2026 host stadiums, filter by country · Responds with 200 Link to this endpointGET /worldcup/v1/venues/{id} — Get a stadium with its scheduled matches · Responds with 200 404 Link to this endpointGolden Boot race
GET /worldcup/v1/players/top-scorers — Golden Boot race — top scorers so far · Responds with 200 422 Link to this endpointlimited seats, real conflicts
POST /worldcup/v1/tickets — Buy match tickets — limited seats, 409 when sold out (requires Bearer auth) · Responds with 201 400 409 422 Link to this endpointGET /worldcup/v1/tickets/{id} — Get a ticket order (410 after cancellation) (requires Bearer auth) · Responds with 200 404 410 Link to this endpointDELETE /worldcup/v1/tickets/{id} — Cancel a ticket order and release the seats (admin only) (requires Bearer auth) · Responds with 204 404 410 Link to this endpointmascots and predictions
POST /worldcup/v1/predictions — Predict the 2026 world champion · Responds with 201 422 Link to this endpointGET /worldcup/v1/predictions/leaderboard — Most-predicted champions · Responds with 200 Link to this endpointGET /worldcup/v1/fanzone/mascots — Meet Maple, Zayu and Clutch — the official 2026 mascots · Responds with 200 Link to this endpointLast updated