---
title: "NBA matchup intelligence endpoint (season aggregates, last-5, rosters, H2H)"
method: GET
path: "/v1/nba/games/{id}/matchup"
tags: ["nerd"]
---

# NBA matchup intelligence endpoint (season aggregates, last-5, rosters, H2H)

`GET /v1/nba/games/{id}/matchup`

## Request

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

Match meta + live state + per-team season aggregates + last-5 +
rest days + active-roster averages + H2H. 60s cache.
Legacy alias: `GET /v1/nerd/nba/games/{id}/matchup` (sunset 2026-09-01).

## Path parameters

- `id` string, uuid, required

## Query parameters

- `view` 'nerd'

## Response `200`

ok

- object

## Other responses

- `400`: invalid game_id
- `404`: NBA match not found

---

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