---
title: "List team_news for NBA"
method: GET
path: "/api/v1/nba/team_news"
tags: ["NBA"]
---

# List team_news for NBA

`GET /api/v1/nba/team_news`

## Request

- Base URL: `https://api.stat-api.com`
- URL: `https://api.stat-api.com/api/v1/nba/team_news`
- Auth: HTTP bearer

⚠️ This endpoint is documented but not yet live. Calls return 503 until the NBA data load is in production.

## Query parameters

- `team_id` integer
- `category` 'game_preview' | 'coaching' | 'transaction' | 'general' | 'draft' | 'depth_chart'
- `urgency` 'BREAKING_GAME_TIME' | 'HIGH' | 'MEDIUM' | 'ROUTINE'
- `news_time` string, date-time
- `news_time__gte` string, date-time
- `news_time__lte` string, date-time
- `news_time__between` string, date-time
- `limit` integer
- `from_id` integer
- `format` 'json' | 'csv'

## Response `200`

team_news rows matching the declared filter set.

- NBATeamNewsListResponse
  - `has_more` boolean, required: True when a full page came back, so more rows can exist.
  - `limit` integer, required: Page size used for this response.
  - `next_from_id` integer, nullable, required: Pass this as `from_id` on the next request to page forward. `null` on the terminal page, and on a first page requested without `from_id` (that page uses the default sort): to walk every row, start with `from_id=0`.
  - `team_news` NBATeamNews[], required
    - `ai_processed` boolean, nullable: Whether this story was generated or enriched via LLM summarization.
    - `category` string, nullable: game_preview, coaching, transaction, general
    - `game_id` integer, nullable: Associated game ID when news relates to a specific game.
    - `id` integer, required: Primary Key
    - `news_time` string, date-time, required: Publication timestamp of the team story.
    - `opponent_team_id` integer, nullable: Opponent team ID when news relates to an upcoming or completed game matchup.
    - `summary` string, required: Concise journalistic summary of the team news event.
    - `team_id` integer, required: Team ID that this news event pertains to.
    - `title` string, required: Headline of the team news story.
    - `urgency` string, nullable: ROUTINE, MEDIUM, HIGH, BREAKING_GAME_TIME

## Other responses

- `400`: No declared filter set was satisfied by the request — see `accepted` in the body for the valid combinations.
- `503`: Coming soon — handler returns 503 until data is wired in.

---

[API](https://skmtc.dev/stat-api/apis/sports-db-public-api.md) · [All operations](https://skmtc.dev/stat-api/apis/sports-db-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/stat-api/apis/sports-db-public-api/revisions/601ff9eaca3f?raw)