Teams Endpoint

Retrieve information about teams within supported leagues.

GET

/api/v1/nba/odds/teams

Description

Returns a list of teams for one or more leagues. Use this to map team IDs to human-readable names when working with odds data.

Parameters

Name	Type	Required	Description
`league_id`	integer	Optional	Filter teams by league ID.
`team_id`	integer	Optional	One or more team IDs (comma-separated) to filter on.
`conference`	string	Optional	Filter by conference (for leagues that use conferences).
`division`	string	Optional	Filter by division (for leagues that use divisions).

Example Request

curl -X 'GET' \
'http://localhost:5000/api/v1/nba/odds/teams?league_id=4&team_id=101,102&conference=EASTERN&division=CENTRAL' \
  -H 'accept: */*' \
  -H 'Authorization: Bearer sk_your_api_key_here'

Example Response

{
  "success": true,
  "data": [
    {
      "id": 101,
      "full_name": "Example City Hawks",
      "display_name": "Hawks",
      "short_name": "Hawks",
      "location": "Example City",
      "abbr": "ECH",
      "logo": "https://example.com/logos/teams/example-city-hawks.png",
      "primary_color": "123456",
      "secondary_color": "ABCDEF",
      "conference_type": "EASTERN",
      "division_type": "CENTRAL",
      "url_slug": "example-city-hawks",
      "standings": {
        "win": 25,
        "loss": 18,
        "ties": null,
        "overtime_losses": null,
        "draw": null
      },
      "core_id": 9001
    },
    {
      "id": 102,
      "full_name": "Sample Town Bears",
      "display_name": "Bears",
      "short_name": "Bears",
      "location": "Sample Town",
      "abbr": "STB",
      "logo": "https://example.com/logos/teams/sample-town-bears.png",
      "primary_color": "654321",
      "secondary_color": "FEDCBA",
      "conference_type": "WESTERN",
      "division_type": "PACIFIC",
      "url_slug": "sample-town-bears",
      "standings": {
        "win": 19,
        "loss": 24,
        "ties": null,
        "overtime_losses": null,
        "draw": null
      },
      "core_id": 9002
    }
  ],
  "count": 2
}