Competitions
Competition Details
Get comprehensive details about a specific competition or league
GET
Upcoming Games
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 thecompetitions array along with upcoming matches.
Request
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) |
All
startTime fields in game data use ISO 8601 format with a dynamic timezone offset based on the resolved or specified timezone.Request Examples
Response
Thecompetitions array in the response contains competition details:
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 thenameForURL field to construct URLs:
Related Endpoints
- Competition Standings - Get league table
- Competition Fixtures - Get upcoming matches
- Competition Results - Get past match results
- Featured Competitions - Get popular leagues
Last modified on March 15, 2026
Upcoming Games