FIBA World Cup API — free mock REST API for testing

A FIBA Basketball World Cup 2027 sandbox in Qatar: 32 teams in eight groups, games simulated quarter by quarter with overtime, ETag-guarded team staff and box scores.

The FIBA World Cup API models the 2027 Basketball World Cup in Qatar, and it is built around the fact that basketball has no draws. Simulating a game plays four quarters possession by possession and then keeps adding five-minute overtimes until somebody is ahead, so the group table can use FIBA’s real classification system — two points for a win, one for a loss — and never needs a draw column. Everything downstream is derived from that one write: the box score, the cursor-paged play-by-play, the tournament leaders and the MVP race all read the plays the simulation produced, and none of them can be written directly.

Base URL: https://funapi.dev/api/fiba/v1 · 22 endpoints · OpenAPI 3.1 spec and Postman collection available. New here? Read the getting started guide.

What you can practise here

• GET /teams/32, keep the ETag, then PUT /teams/32/staff with If-Match: v1 — repeat the same request and read the 412 the second, now-stale etag earns.
• Name a captain who plays for another nation and compare that 422 with the 412 above: one is a stale precondition, the other a body that can never be valid.
• GET /groups/A/standings, send its ETag back as If-None-Match for a 304 with no body, then simulate a group A game and watch the same header start returning 200 again.
• POST /games/1/simulate as admin, then walk GET /games/1/play-by-play?limit=5 by following nextCursor until it comes back null.
• POST /games/1/challenge for the home bench (it takes ~3s — a real replay review), then challenge again from the same bench for the 409.
• POST /games/1/highlights for a 202 and a Location, then poll GET /highlights/1 until progress hits 100 and a downloadUrl appears.
• GET /players/63/advanced for a 402 Payment Required that never succeeds, and buy the last seats for a game to turn POST /tickets into a 409.

teams

the 32 qualified nations

• GET /fiba/v1/teams — List qualified teams (filter by group, FIBA zone or hosts)
• GET /fiba/v1/teams/{id} — Get one national team — carries the ETag its staff update needs
• PUT /fiba/v1/teams/{id}/staff — Name the head coach and captain — optimistic concurrency via If-Match (requires Bearer auth)
• GET /fiba/v1/groups/{letter}/standings — Group table computed from finished games — cacheable (ETag / If-None-Match / 304)

games

simulation, box scores and reviews

• GET /fiba/v1/games — List games (filter by stage, status, group or team)
• GET /fiba/v1/games/{id} — Get one game with team and arena names resolved
• POST /fiba/v1/games/{id}/simulate — Tip off — four quarters plus overtime until somebody wins (admin only) (requires Bearer auth)
• GET /fiba/v1/games/{id}/boxscore — Per-player box score, derived from the play-by-play
• GET /fiba/v1/games/{id}/play-by-play — Cursor-paged play-by-play — follow nextCursor to the final buzzer
• POST /fiba/v1/games/{id}/challenge — Coach's challenge — a slow (~3s) replay review, one per team (requires Bearer auth)
• POST /fiba/v1/games/{id}/highlights — Queue a highlight reel — 202 Accepted, then poll the job (requires Bearer auth)
• GET /fiba/v1/highlights/{id} — Poll a highlight job until it is ready

arenas

the Doha host courts

• GET /fiba/v1/arenas — List the Qatar host arenas, filter by city
• GET /fiba/v1/arenas/{id} — Get one arena with the games it hosts

players

stat leaders and the MVP race

• GET /fiba/v1/players — List players (filter by team or position)
• GET /fiba/v1/players/{id} — Get one player with their running tournament totals
• GET /fiba/v1/players/leaders — Tournament leaders for points, rebounds or assists
• GET /fiba/v1/players/{id}/advanced — Tracking data — always 402, it is on the paid analytics tier
• GET /fiba/v1/fanzone/mvp — The MVP race, ranked by a simplified efficiency index

tickets

limited seats, real conflicts

• POST /fiba/v1/tickets — Buy tickets — seats are limited, so 409 when the game sells out (requires Bearer auth)
• GET /fiba/v1/tickets/{id} — Get a ticket order — 410 once it has been cancelled
• DELETE /fiba/v1/tickets/{id} — Cancel an order and release the seats (requires Bearer auth)

Related APIs

• Pizza Orders API — Place & track orders. Includes a guaranteed 500.
• Coffee Shop API — Drinks & orders. Home of the legendary 418.
• Football API — Teams, squads, standings & simulated matches.
• Bank API — Accounts, transfers & cursor pagination. Home of the 402.

All 39 mock REST APIs