---
title: "Aggregated team stats (W/D/L, goals, BTTS, O/U, form string)"
method: GET
path: "/v1/teams/{id}/stats"
tags: ["teams"]
---

# Aggregated team stats (W/D/L, goals, BTTS, O/U, form string)

`GET /v1/teams/{id}/stats`

## Request

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

## Path parameters

- `id` string, uuid, required

## Query parameters

- `tournament` 'wc2026'

## Response `200`

ok

- object
  - `data` object
    - `matches_played` integer
    - `matches_with_scores` integer
    - `wins` integer
    - `draws` integer
    - `losses` integer
    - `goals_scored` integer
    - `goals_conceded` integer
    - `goal_difference` integer
    - `clean_sheets` integer
    - `points` integer
    - `form_string` string: Last 5 results, oldest→newest e.g. 'WWDLW'
    - `btts_rate` number: Fraction of scored matches where both teams scored (0–1)
    - `over_2_5_rate` number: Fraction of scored matches with 3+ total goals (0–1)
    - `avg_goals_scored` number
    - `avg_goals_conceded` number

## Other responses

- `404`: team not found or not in requested tournament

---

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