---
title: "National team World Cup history (2002-2022)"
method: GET
path: "/v1/teams/{id}/world-cup-history"
tags: ["teams"]
---

# National team World Cup history (2002-2022)

`GET /v1/teams/{id}/world-cup-history`

## Request

- Base URL: `https://api.bigballsdata.com`
- URL: `https://api.bigballsdata.com/v1/teams/{id}/world-cup-history`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

A nation's World Cup record across past tournaments, most recent first.
Response array item keys: year, tournament, finish, games_played, wins,
draws, losses, goals_for, goals_against. Covers the 48 WC2026-qualified
nations, so non-qualified former champions (e.g. Italy, the 2006 champion)
are absent; and for a nation present, a penalty-shootout final is not
labelled "champion" in finish (the seeder derives it from the regulation
final score). 24-hour cache.

## Path parameters

- `id` string, uuid, required

## Response `200`

ok

- object

## Other responses

- `400`: invalid team id

---

[API](https://skmtc.dev/bigballsdata/apis/big-ball-sports-api.md) · [All operations](https://skmtc.dev/bigballsdata/apis/big-ball-sports-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bigballsdata/apis/big-ball-sports-api/revisions/31fb54ac414e?raw)