> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sportsapipro.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Competition Details

> Get comprehensive details about a specific competition or league

## Overview

To fetch detailed information about a specific competition (league/tournament), use the fixtures endpoint with the competition ID. The response includes competition metadata in the `competitions` array along with upcoming matches.

## Request

```
GET https://v1.football.sportsapipro.com/games/fixtures?competitions={competitionId}
```

## Parameters

| Parameter      | Type    | Description                                                                        |
| -------------- | ------- | ---------------------------------------------------------------------------------- |
| `competitions` | number  | Competition ID to fetch details for                                                |
| `showOdds`     | boolean | Include betting odds (optional)                                                    |
| `timezoneName` | string  | Timezone for date/time values (auto-resolved, or specify e.g., `America/New_York`) |

<Note>
  All `startTime` fields in game data use ISO 8601 format with a dynamic timezone offset based on the resolved or specified timezone.
</Note>

## Request Examples

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET "https://v1.football.sportsapipro.com/games/fixtures?competitions=7685" \
    -H "x-api-key: YOUR_API_KEY"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    "https://v1.football.sportsapipro.com/games/fixtures?competitions=7685",
    {
      headers: { "x-api-key": "YOUR_API_KEY" }
    }
  );
  const data = await response.json();

  // Find competition in the response
  const competition = data.competitions?.find(c => c.id === 7685);
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      "https://v1.football.sportsapipro.com/games/fixtures",
      params={"competitions": 7685},
      headers={"x-api-key": "YOUR_API_KEY"}
  )
  data = response.json()

  # Find competition in the response
  competition = next(
      (c for c in data.get("competitions", []) if c["id"] == 7685),
      None
  )
  ```
</CodeGroup>

## Response

The `competitions` array in the response contains competition details:

```json theme={null}
{
  "competitions": [
    {
      "id": 7685,
      "countryId": 205,
      "sportId": 1,
      "name": "UEFA Conference League",
      "nameForURL": "uefa-conference-league",
      "hasBrackets": true,
      "hasStandings": true,
      "imageVersion": 1,
      "popularityRank": 150,
      "country": {
        "id": 205,
        "name": "Europe"
      }
    }
  ],
  "games": [
    // Array of upcoming fixtures
  ]
}
```

## Competition Fields

| Field            | Type    | Description                                         |
| ---------------- | ------- | --------------------------------------------------- |
| `id`             | number  | Unique competition identifier                       |
| `countryId`      | number  | ID of the country/region the competition belongs to |
| `sportId`        | number  | ID of the sport (1 = Football)                      |
| `name`           | string  | Full competition name                               |
| `nameForURL`     | string  | URL-friendly name for SEO                           |
| `hasBrackets`    | boolean | Whether bracket/knockout stage data is available    |
| `hasStandings`   | boolean | Whether standings/table data is available           |
| `imageVersion`   | number  | Version number for logo assets                      |
| `popularityRank` | number  | Popularity score (lower = more popular)             |
| `country`        | object  | Country information with id and name                |

## SEO-Friendly URLs

For SEO purposes, use the `nameForURL` field to construct URLs:

```
/sports/competition/{nameForURL}-{id}
```

Example:

```
/sports/competition/uefa-conference-league-7685
```

The route extracts the ID from the last segment of the slug (after the final hyphen) to fetch the competition data.

## Related Endpoints

* [Competition Standings](/api-reference/standings/standings) - Get league table
* [Competition Fixtures](/api-reference/games/fixtures) - Get upcoming matches
* [Competition Results](/api-reference/games/results) - Get past match results
* [Featured Competitions](/api-reference/competitions/featured) - Get popular leagues


## OpenAPI

````yaml GET /games/fixtures
openapi: 3.1.0
info:
  title: SportsAPI Pro - Basketball API
  description: >-
    Professional basketball data API providing live scores, standings, player
    statistics, betting odds, and more for NBA, EuroLeague, and 50+ leagues
    worldwide.
  version: 1.0.0
  contact:
    name: SportsAPI Pro Support
    email: support@sportsapipro.com
servers:
  - url: https://v1.basketball.sportsapipro.com
    description: Production API Server
security:
  - ApiKeyAuth: []
tags:
  - name: Games
    description: Live scores, fixtures, and game data
  - name: Competitions
    description: Leagues and tournaments
  - name: Standings
    description: League standings and rankings
  - name: Athletes
    description: Player statistics and data
  - name: Betting
    description: Betting lines, props, and predictions
  - name: Search
    description: Search entities
  - name: Account
    description: Account status and usage
paths:
  /games/fixtures:
    get:
      tags:
        - Games
      summary: Upcoming Games
      description: Get upcoming basketball games (fixtures)
      operationId: getFixtures
      parameters:
        - name: competitions
          in: query
          description: Filter by competition ID
          schema:
            type: integer
            example: 132
        - name: date
          in: query
          description: Filter by date (YYYY-MM-DD)
          schema:
            type: string
            format: date
            example: '2026-01-26'
      responses:
        '200':
          description: Fixtures retrieved successfully
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: Your SportsAPI Pro API key

````