Skip to main content
GET
/
games
/
fixtures
Upcoming Games
curl --request GET \
  --url https://v1.basketball.sportsapipro.com/games/fixtures \
  --header 'x-api-key: <api-key>'

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

ParameterTypeDescription
competitionsnumberCompetition ID to fetch details for
showOddsbooleanInclude betting odds (optional)
timezoneNamestringTimezone 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

curl -X GET "https://v1.football.sportsapipro.com/games/fixtures?competitions=7685" \
  -H "x-api-key: YOUR_API_KEY"

Response

The competitions array in the response contains competition details:
{
  "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

FieldTypeDescription
idnumberUnique competition identifier
countryIdnumberID of the country/region the competition belongs to
sportIdnumberID of the sport (1 = Football)
namestringFull competition name
nameForURLstringURL-friendly name for SEO
hasBracketsbooleanWhether bracket/knockout stage data is available
hasStandingsbooleanWhether standings/table data is available
imageVersionnumberVersion number for logo assets
popularityRanknumberPopularity score (lower = more popular)
countryobjectCountry 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.

Authorizations

x-api-key
string
header
required

Your SportsAPI Pro API key

Query Parameters

competitions
integer

Filter by competition ID

Example:

132

date
string<date>

Filter by date (YYYY-MM-DD)

Example:

"2026-01-26"

Response

200

Fixtures retrieved successfully