Catalog

Season summaries for a sport

GET/v1/seasons

Bearer keyCursor paginatedJSON onlyReturns Season[]

Request

curl

curl "https://api.thebettinginsider.com/v1/seasons?sport=mlb" \
  -H "Authorization: Bearer tbi_live_YOUR_KEY"

Parameters

Parameter	Type	Description
sportrequired	enum	Sport. `ncaaf` is FBS college football.mlbnflncaafnbanhl

Paging and CSV behave the same on every list endpoint — see Pagination & CSV.

Response

Captured from production on 2026-10-13, trimmed to two rows. GET /v1/seasons?sport=mlb

200 OK

{
  "data": [
    {
      "sport": "mlb",
      "season": 2022,
      "status": "published",
      "first_game": "2022-04-07",
      "last_game": "2022-11-05",
      "games": 2470,
      "regular_season_games": 2430,
      "postseason_games": 40,
      "weeks": null
    },
    {
      "sport": "mlb",
      "season": 2023,
      "status": "published",
      "first_game": "2023-03-30",
      "last_game": "2023-11-01",
      "games": 2471,
      "regular_season_games": 2430,
      "postseason_games": 41,
      "weeks": null
    }
  ],
  "next_cursor": null,
  "meta": {
    "count": 5,
    "request_id": "f234d2ff-f52d-4c2d-84c6-24442a627bd0"
  }
}

Envelope: { data: Season[], next_cursor: string | null, meta: { count, request_id } }.

Season fields

Field	Type	Description
sport	enum	Sport. `ncaaf` is FBS college football.mlbnflncaafnbanhl
season	integer	—
status	enum	—publishedin_progress
first_game	string \| null	YYYY-MM-DD
last_game	string \| null	YYYY-MM-DD
games	integer	—
regular_season_games	integer \| null	—
postseason_games	integer \| null	—
weeks	integer \| null	NFL/NCAAF: highest completed week

Errors

Status	When
400	Invalid parameter
401	Missing or unknown API key
403	Key revoked or subscription inactive
429	Rate limit or monthly quota exceeded (see `Retry-After`)

All errors share one envelope — see Errors.