---
title: "WC2026 team squad (26 players)"
method: GET
path: "/v1/wc2026/teams/{id}/squad"
tags: ["nerd"]
---

# WC2026 team squad (26 players)

`GET /v1/wc2026/teams/{id}/squad`

## Request

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

Full World Cup squad for one nation, ordered by position group
(Goalkeeper, Defender, Midfielder, Attacker) then shirt number.
Response object keys: team {id, name, short_name}, squad[]
(player_id, name, shirt_number, position, age, photo_url).
player_id is null for the few players not yet bridged; those are
identified by name. 1-hour Redis cache.

## Path parameters

- `id` string, uuid, required

## Response `200`

ok

- object
  - `data` object
    - `team` object
    - `squad` object[]
      - `player_id` string, uuid, nullable
      - `name` string
      - `shirt_number` integer, nullable
      - `position` string, nullable
      - `age` integer, nullable
      - `photo_url` string, uri, nullable

## Other responses

- `400`: invalid team id
- `404`: not a WC2026 team

---

[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)