---
updatedAt: 2025-10-30T15:17:09.000Z
agentTools:
  siteIndex: https://developer.sportradar.com/llms.txt
  projectIndex: https://developer.sportradar.com/baseball/llms.txt
---

# Season Competitors

**Global Baseball Season Competitors** provides a list of teams participating for a given season.

<Callout icon="⏱️" theme="default">
  ### Update Frequency

  300s Time To Live / Cache
</Callout>

***

## Data Points

<Accordion title="Competitor" icon="fa-duotone fa-thin fa-baseball">

| Attribute | Parent Element | Type | Description |
| --------- | -------------- | ---- | ----------- |
| `abbreviation` | `competitor` | String | Abbreviation for a competitor name<br /><br />ex. `LAD` (Los Angeles Dodgers) |
| `id` | `competitor` | String | Unique ID for a competitor<br /><br />ex. `sr:competitor:3638` (Los Angeles Dodgers) |
| `name` | `competitor` | String | Name for a competitor<br /><br />ex. `Los Angeles Dodgers` |
| `short_name` | `competitor` | String | Name for a competitor<br /><br />ex. `LA Dodgers` |

</Accordion>

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "sportradar-api",
    "version": "8"
  },
  "servers": [
    {
      "url": "https://api.sportradar.com/"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "apiKey",
        "in": "header",
        "name": "x-api-key"
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/{sport}/{access_level}/v2/{language_code}/seasons/{season_id}/competitors.{format}": {
      "get": {
        "summary": "Season Competitors",
        "description": "**Global Baseball Season Competitors** provides a list of teams participating for a given season.",
        "operationId": "global-baseball-season-competitors",
        "parameters": [
          {
            "name": "sport",
            "in": "path",
            "description": "Sport type<br><br>`baseball`, `softball`",
            "schema": {
              "type": "string",
              "enum": [
                "baseball",
                "softball"
              ],
              "default": "baseball"
            },
            "required": true
          },
          {
            "name": "access_level",
            "in": "path",
            "description": "The access level of your API key<br><br>`trial`, `production`",
            "schema": {
              "type": "string",
              "enum": [
                "trial",
                "production"
              ],
              "default": "trial"
            },
            "required": true
          },
          {
            "name": "language_code",
            "in": "path",
            "description": "2-letter code for supported languages<br><br>`en` (English), `es` (Spanish), `ja` (Japanese), `ko` (Korean), `zh` (Chinese - simplified), `zht` (Chinese - traditional)<br><br>The above codes are the fully supported languages for this API. Click <span style=\"text-decoration:underline\">[here](https://api-docs.sportradar.us/misc/Sportradar_API_Languages.xlsx)</span> for valid language codes and a tabular list of available languages per competition.",
            "schema": {
              "type": "string",
              "enum": [
                "en",
                "es",
                "ja",
                "ko",
                "zh",
                "zht"
              ],
              "default": "en"
            },
            "required": true
          },
          {
            "name": "season_id",
            "in": "path",
            "description": "Unique Id of a season, found in the <span style=\"text-decoration:underline\">[Seasons](https://developer.sportradar.com/baseball/reference/global-baseball-seasons)</span> endpoint<br><br>**Note:** The API provides a maximum of 3 seasons per competition — 2 previous seasons and 1 current season.<br><br>**Example:** `sr:season:128221`",
            "schema": {
              "type": "string",
              "default": "sr:season:128221"
            },
            "required": true
          },
          {
            "name": "format",
            "in": "path",
            "description": "Format returned<br><br>`json`, `xml`",
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "xml"
              ],
              "default": "json"
            },
            "required": true
          },
          {
            "name": "start",
            "in": "query",
            "description": "The number of items to skip before starting to collect the result set.<br>Default: `0`<br><br>Example: `start=1000` to receive a 2nd page of results (if necessary)<br><br><i>Note: You may alternatively use `offset`</i>",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "The number of items to return.<br>Maximum: `1000`<br>Default value: `1000`<br><br>Example: `limit=5`",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n  \"generated_at\": \"2022-11-30T22:06:34.189Z\",\n  \"season_competitors\": [\n    {\n      \"abbreviation\": \"string\",\n      \"id\": \"string\",\n      \"name\": \"string\",\n      \"short_name\": \"string\",\n      \"virtual\": true\n    }\n  ]\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "generated_at": {
                      "type": "string",
                      "example": "2022-11-30T22:06:34.189Z"
                    },
                    "season_competitors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "abbreviation": {
                            "type": "string",
                            "example": "string"
                          },
                          "id": {
                            "type": "string",
                            "example": "string"
                          },
                          "name": {
                            "type": "string",
                            "example": "string"
                          },
                          "short_name": {
                            "type": "string",
                            "example": "string"
                          },
                          "virtual": {
                            "type": "boolean",
                            "example": true,
                            "default": true
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```