---
updatedAt: 2025-10-30T14:52:36.000Z
agentTools:
  siteIndex: https://developer.sportradar.com/llms.txt
  projectIndex: https://developer.sportradar.com/basketball/llms.txt
---

# Competition Info

**Global Basketball Competition Info** Provides the name, id, and parent id for a given competition.

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

  300s Time To Live / Cache
</Callout>

***

## Data Points

<Accordion title="Category & Sport" icon="fa-duotone fa-thin fa-basketball-hoop">

| Attribute | Parent Element | Type | Description |
| --------- | -------------- | ---- | ----------- |
| `country_code` | `competition` - `category` | String | Country code for a competition category<br /><br />ex. `FRA` (France) |
| `id` | `competition` - `category` | String | Unique category ID for a competition<br /><br />ex. `sr:category:110` |
| `name` | `competition` - `category` | String | Name for a competition category<br /><br />ex. `France` |

</Accordion>

<Accordion title="Competition" icon="fa-duotone fa-thin fa-basketball-hoop">

| Attribute | Parent Element | Type | Description |
| --------- | -------------- | ---- | ----------- |
| `gender` | `competition` | String | Gender for a competition<br /><br />`men`, `women` |
| `id` | `competition` | String | Unique ID for a competition<br /><br />ex. `sr:competition:264` (Liga ACB) |
| `name` | `competition` | String | Name of a competition<br /><br />ex. `Pro A`, `NBA` |
| `parent_id` | `competition` | String | Unique parent ID for a competition. Typically present for group competitions<br /><br />ex. `sr:competition:30190` used to group NCAA postseason tournaments. |

</Accordion>

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "global-basketball",
    "version": "8"
  },
  "servers": [
    {
      "url": "https://api.sportradar.com/basketball/"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "apiKey",
        "in": "header",
        "name": "x-api-key"
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/{access_level}/v2/{language_code}/competitions/{competition_id}/info.{format}": {
      "get": {
        "summary": "Competition Info",
        "description": "**Global Basketball Competition Info** Provides the name, id, and parent id for a given competition.",
        "operationId": "global-basketball-competition-info",
        "parameters": [
          {
            "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>`da` (Danish), `de` (German), `el` (Greek), `en` (English), `es` (Spanish), `fi` (Finnish), `fr` (French), `hi` (Hindi), `hu` (Hungarian), `id` (Indonesian), `it` (Italian), `ja` (Japanese), `ko` (Korean), `nl` (Dutch), `no` (Norwegian), `pt` (Portuguese), `ru` (Russian), `sr` (Serbian), `srl` (Serbian Latin), `sv` (Swedish), `th` (Thai), `tr` (Turkish), `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": [
                "da",
                "de",
                "el",
                "en",
                "es",
                "fi",
                "fr",
                "hi",
                "hu",
                "id",
                "it",
                "ja",
                "ko",
                "nl",
                "no",
                "pt",
                "ru",
                "sr",
                "srl",
                "sv",
                "th",
                "tr",
                "zh",
                "zht"
              ],
              "default": "en"
            },
            "required": true
          },
          {
            "name": "competition_id",
            "in": "path",
            "description": "Unique Id of a competition, found in the <span style=\"text-decoration:underline\">[Competitions](https://developer.sportradar.com/basketball/reference/global-basketball-competitions)</span> endpoint.<br><br>**Example:** `sr:competition:138`",
            "schema": {
              "type": "string",
              "default": "sr:competition:138"
            },
            "required": true
          },
          {
            "name": "format",
            "in": "path",
            "description": "Format returned<br><br>`json`, `xml`",
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "xml"
              ],
              "default": "json"
            },
            "required": true
          }
        ],
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n  \"competition\": {\n    \"children\": [\n      {\n        \"gender\": \"string\",\n        \"id\": \"string\",\n        \"name\": \"string\",\n        \"parent_id\": \"string\",\n        \"type\": \"string\"\n      }\n    ],\n    \"gender\": \"string\",\n    \"id\": \"string\",\n    \"name\": \"string\",\n    \"parent_id\": \"string\",\n    \"type\": \"string\"\n  },\n  \"generated_at\": \"2022-11-17T20:21:12.478Z\",\n  \"info\": {\n    \"competition_status\": \"delayed\",\n    \"venue_reduced_capacity\": true,\n    \"venue_reduced_capacity_max\": 0\n  }\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "competition": {
                      "type": "object",
                      "properties": {
                        "children": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "gender": {
                                "type": "string",
                                "example": "string"
                              },
                              "id": {
                                "type": "string",
                                "example": "string"
                              },
                              "name": {
                                "type": "string",
                                "example": "string"
                              },
                              "parent_id": {
                                "type": "string",
                                "example": "string"
                              },
                              "type": {
                                "type": "string",
                                "example": "string"
                              }
                            }
                          }
                        },
                        "gender": {
                          "type": "string",
                          "example": "string"
                        },
                        "id": {
                          "type": "string",
                          "example": "string"
                        },
                        "name": {
                          "type": "string",
                          "example": "string"
                        },
                        "parent_id": {
                          "type": "string",
                          "example": "string"
                        },
                        "type": {
                          "type": "string",
                          "example": "string"
                        }
                      }
                    },
                    "generated_at": {
                      "type": "string",
                      "example": "2022-11-17T20:21:12.478Z"
                    },
                    "info": {
                      "type": "object",
                      "properties": {
                        "competition_status": {
                          "type": "string",
                          "example": "delayed"
                        },
                        "venue_reduced_capacity": {
                          "type": "boolean",
                          "example": true,
                          "default": true
                        },
                        "venue_reduced_capacity_max": {
                          "type": "integer",
                          "example": 0,
                          "default": 0
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```