Team API lookup pilot

Boston Celtics API team ID

NBA · basketball · BOS

Build with Boston Celtics data

Use this canonical ID in the team-detail request below. It identifies this team in Big Balls Sports Data, not in another provider's API.

b4d31813-a907-4b4b-9973-d6fb0bc6509d

Find the team by name

Set BBS_API_KEY to your own API key. Name search can match aliases; confirm the returned identity before using an ID. For a broader catalogue, follow limit and offset and read pagination.total rather than treating one page as the full list.

curl 'https://api.bigballsdata.com/v1/teams?sport=basketball&league=nba&name=Boston+Celtics&limit=2' -H "x-api-key: $BBS_API_KEY"

Fetch this team

curl 'https://api.bigballsdata.com/v1/teams/b4d31813-a907-4b4b-9973-d6fb0bc6509d?sport=basketball' -H "x-api-key: $BBS_API_KEY"

Captured on . This is a selected-field excerpt of a real response, not live data or the complete response. Match totals cover all finished matches held for this team; they are not a current-season record or a claim of complete historical coverage.

{
  "data": {
    "id": "b4d31813-a907-4b4b-9973-d6fb0bc6509d",
    "name": "Boston Celtics",
    "short_name": "BOS",
    "sport": "basketball",
    "league": "NBA",
    "stats": {
      "matches_played": 656,
      "matches_with_scores": 656,
      "wins": 434,
      "draws": 0,
      "losses": 222
    }
  },
  "meta": {
    "stats_scope": "all finished matches held for this team"
  }
}