Team API lookup pilot

New York Yankees API team ID

MLB · baseball · NYY

Build with New York Yankees 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.

69ac6443-3e8b-47d5-bca3-74f1d77a3a5b

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=baseball&league=mlb&name=New+York+Yankees&limit=2' -H "x-api-key: $BBS_API_KEY"

Fetch this team

curl 'https://api.bigballsdata.com/v1/teams/69ac6443-3e8b-47d5-bca3-74f1d77a3a5b?sport=baseball' -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": "69ac6443-3e8b-47d5-bca3-74f1d77a3a5b",
    "name": "New York Yankees",
    "short_name": "NYY",
    "sport": "baseball",
    "league": "MLB",
    "stats": {
      "matches_played": 5843,
      "matches_with_scores": 5842,
      "wins": 3336,
      "draws": 6,
      "losses": 2500
    }
  },
  "meta": {
    "stats_scope": "all finished matches held for this team"
  }
}