> ## 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.

# Featured Competitions

> Retrieve featured competitions with standings support, organized by sport type

## Overview

Returns a curated list of featured competitions that have standings available. This endpoint is useful for displaying prominent leagues and tournaments to users, such as top football leagues (Premier League, LaLiga, Serie A, etc.).

## Request

<ParamField query="sports" type="integer" default="1">
  Sport type filter. Use `1` for Football.
</ParamField>

<ParamField query="type" type="string" default="standings">
  Filter type. Use `standings` to get competitions with standings support.
</ParamField>

<Note>
  The following parameters are **auto-resolved** based on request context:

  * `appTypeId` - Application type identifier
  * `langId` - Language identifier
  * `timezoneName` - User's timezone (can be overridden, e.g., `America/New_York`)
  * `userCountryId` - User's country for localization

  All date/time fields use ISO 8601 format with a dynamic timezone offset.
</Note>

## Response

<ResponseField name="sports" type="array">
  Array of sport definitions included in the response.

  <Expandable title="Sport object properties">
    <ResponseField name="id" type="integer">Sport identifier (1 = Football)</ResponseField>
    <ResponseField name="name" type="string">Display name of the sport</ResponseField>
    <ResponseField name="nameForURL" type="string">URL-safe name</ResponseField>
    <ResponseField name="drawSupport" type="boolean">Whether the sport supports draws</ResponseField>
    <ResponseField name="imageVersion" type="integer">Version number for sport image</ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="countries" type="array">
  Array of countries that have featured competitions.

  <Expandable title="Country object properties">
    <ResponseField name="id" type="integer">Country identifier</ResponseField>
    <ResponseField name="name" type="string">Country name</ResponseField>
    <ResponseField name="nameForURL" type="string">URL-safe country name</ResponseField>
    <ResponseField name="totalGames" type="integer">Total number of games (optional)</ResponseField>
    <ResponseField name="liveGames" type="integer">Number of live games (optional)</ResponseField>
    <ResponseField name="sportTypes" type="array">Array of sport IDs available in this country</ResponseField>
    <ResponseField name="imageVersion" type="integer">Version number for country flag image</ResponseField>
    <ResponseField name="isInternational" type="boolean">Whether this is an international entity (e.g., Europe)</ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="competitions" type="array">
  Array of featured competition objects.

  <Expandable title="Competition object properties">
    <ResponseField name="id" type="integer">Competition identifier</ResponseField>
    <ResponseField name="countryId" type="integer">Country the competition belongs to</ResponseField>
    <ResponseField name="sportId" type="integer">Sport type (1 = Football)</ResponseField>
    <ResponseField name="name" type="string">Full competition name</ResponseField>
    <ResponseField name="shortName" type="string">Abbreviated name (optional)</ResponseField>
    <ResponseField name="longName" type="string">Extended name (optional)</ResponseField>
    <ResponseField name="nameForURL" type="string">URL-safe competition name</ResponseField>
    <ResponseField name="hasStandings" type="boolean">Whether standings are available</ResponseField>
    <ResponseField name="hasBrackets" type="boolean">Whether bracket/knockout data is available</ResponseField>
    <ResponseField name="hasStats" type="boolean">Whether statistics are available</ResponseField>
    <ResponseField name="hasTransfers" type="boolean">Whether transfer data is available</ResponseField>
    <ResponseField name="hasLiveStandings" type="boolean">Whether live standings updates are supported</ResponseField>
    <ResponseField name="hasStandingsGroups" type="boolean">Whether standings have group stages</ResponseField>
    <ResponseField name="hasBets" type="boolean">Whether betting data is available</ResponseField>
    <ResponseField name="hasCurrentStageStandings" type="boolean">Whether current stage has standings</ResponseField>
    <ResponseField name="hasHistory" type="boolean">Whether historical data is available</ResponseField>
    <ResponseField name="isActive" type="boolean">Whether the competition is currently active</ResponseField>
    <ResponseField name="popularityRank" type="integer">Popularity score for sorting</ResponseField>
    <ResponseField name="tableName" type="string">Display name for standings table</ResponseField>
    <ResponseField name="bracketsName" type="string">Display name for bracket view (optional)</ResponseField>
    <ResponseField name="currentSeasonNum" type="integer">Current season number</ResponseField>
    <ResponseField name="currentStageNum" type="integer">Current stage number</ResponseField>
    <ResponseField name="currentPhaseName" type="string">Name of current phase (optional)</ResponseField>
    <ResponseField name="color" type="string">Brand color (hex format)</ResponseField>
    <ResponseField name="competitorsType" type="integer">Type of competitors (1 = clubs)</ResponseField>
    <ResponseField name="imageVersion" type="integer">Version number for competition logo</ResponseField>
    <ResponseField name="createdAt" type="string">ISO timestamp when competition was added (optional)</ResponseField>
    <ResponseField name="hideOnCatalog" type="boolean">Whether to hide in catalog view</ResponseField>
    <ResponseField name="hideOnSearch" type="boolean">Whether to hide in search results</ResponseField>
  </Expandable>
</ResponseField>

## Example Request

```bash theme={null}
curl -X GET "https://v1.football.sportsapipro.com/competitions/featured?sports=1&type=standings" \
  -H "x-api-key: YOUR_API_KEY"
```

## Example Response

```json theme={null}
{
  "sports": [
    {
      "id": 1,
      "name": "Football",
      "nameForURL": "football",
      "drawSupport": true,
      "imageVersion": 1
    }
  ],
  "countries": [
    {
      "id": 19,
      "name": "Europe",
      "totalGames": 18,
      "liveGames": 0,
      "nameForURL": "europe",
      "imageVersion": 1,
      "isInternational": true
    },
    {
      "id": 1,
      "name": "England",
      "nameForURL": "england",
      "sportTypes": [1, 9, 11],
      "imageVersion": 1,
      "isInternational": false
    }
  ],
  "competitions": [
    {
      "id": 7,
      "countryId": 1,
      "sportId": 1,
      "name": "Premier League",
      "shortName": "EPL",
      "hasStandings": true,
      "hasBrackets": false,
      "hasStats": true,
      "hasTransfers": true,
      "hasLiveStandings": false,
      "hasStandingsGroups": false,
      "hasBets": false,
      "nameForURL": "premier-league",
      "popularityRank": 92856977,
      "tableName": "Standings",
      "currentSeasonNum": 131,
      "currentStageNum": 1,
      "color": "#075C9C",
      "competitorsType": 1,
      "imageVersion": 12,
      "hideOnCatalog": false,
      "hideOnSearch": false,
      "hasCurrentStageStandings": true,
      "hasHistory": true,
      "isActive": true
    },
    {
      "id": 572,
      "countryId": 19,
      "sportId": 1,
      "name": "UEFA Champions League",
      "shortName": "UCL",
      "hasStandings": true,
      "hasBrackets": true,
      "hasStats": true,
      "hasTransfers": false,
      "hasLiveStandings": false,
      "hasStandingsGroups": false,
      "hasBets": false,
      "nameForURL": "uefa-champions-league",
      "popularityRank": 115687338,
      "tableName": "Standings",
      "bracketsName": "Bracket",
      "currentSeasonNum": 73,
      "currentStageNum": 1,
      "color": "#09123E",
      "competitorsType": 1,
      "imageVersion": 5,
      "hideOnCatalog": false,
      "hideOnSearch": false,
      "hasCurrentStageStandings": true,
      "hasHistory": true,
      "isActive": true
    }
  ]
}
```

## Use Cases

* **Featured Leagues Display**: Show top leagues with standings on the homepage
* **Quick Navigation**: Provide shortcuts to popular competitions
* **League Selector**: Build a dropdown of featured leagues for filtering
* **Standings Widget**: Display standings for multiple top leagues

## Notes

* Competitions are returned sorted by `popularityRank` (higher = more popular)
* The `type=standings` filter ensures only competitions with standings support are returned
* Use the `hasStandings`, `hasBrackets`, `hasStats` fields to determine available features
* Competition logos can be retrieved via the Images API using the competition `id`


## OpenAPI

````yaml GET /competitions/featured
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:
  /competitions/featured:
    get:
      tags:
        - Competitions
      summary: Featured Competitions
      description: Get currently featured basketball competitions
      operationId: getFeaturedCompetitions
      responses:
        '200':
          description: Featured competitions retrieved successfully
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: Your SportsAPI Pro API key

````