Athlete's Next Game

Get the upcoming game for a specific athlete with full match details and betting predictions

GET /athletes/nextGame

Player's Next Game

cURL

curl --request GET \
  --url https://v1.basketball.sportsapipro.com/athletes/nextGame \
  --header 'x-api-key: <api-key>'

Endpoint

GET https://v1.football.sportsapipro.com/athletes/nextGame

Description

Returns the next scheduled game for a specific athlete, including detailed match information, competitor data, venue, betting predictions, and player-specific prop bets. This endpoint is ideal for player-focused betting applications and upcoming match previews.

Parameters

Parameter	Type	Required	Description
athletes	number	Yes	Athlete ID (e.g., 57415 for Ayoub El Kaabi)
fullDetails	boolean	No	Include full game details (default: true)
topBookmaker	number	No	Preferred bookmaker ID for odds (default: 14 for Bet365)
appTypeId	number	No	Client application type identifier (auto-resolved)
langId	number	No	Language identifier (auto-resolved)
timezoneName	string	No	Timezone for date/time values (auto-resolved, or specify e.g., America/New_York)
userCountryId	number	No	User’s country for localization (auto-resolved)

The athletes parameter is required. Use the athlete ID from the /athletes/top endpoint or other athlete endpoints. All startTime fields use ISO 8601 format with a dynamic timezone offset based on the resolved or specified timezone.

Request

cURL

curl -X GET "https://v1.football.sportsapipro.com/athletes/nextGame?athletes=57415&fullDetails=true" \
  -H "x-api-key: YOUR_API_KEY"

Response

{
  "lastUpdateId": 5500197825,
  "requestedUpdateId": -1,
  "ttl": 600,
  "athletes": [
    {
      "id": 57415,
      "name": "Ayoub El Kaabi",
      "shortName": "El Kaabi",
      "nameForURL": "ayoub-el-kaabi",
      "sportId": 1,
      "clubId": 1023,
      "nationalityId": 127,
      "nationalTeamId": 5093,
      "nationalityName": "Morocco",
      "age": 32,
      "gender": 1,
      "status": 1,
      "imageVersion": 0,
      "position": {
        "id": 4,
        "name": "Attacker"
      },
      "formationPosition": {
        "id": 12,
        "name": "Centre Forward",
        "order": 12
      },
      "nextGame": {
        "id": 4365029,
        "sportId": 1,
        "competitionId": 167,
        "competitionDisplayName": "Africa Cup of Nations - Group A",
        "startTime": "2025-12-26T12:00:00+00:00",
        "statusGroup": 2,
        "statusText": "Scheduled",
        "shortStatusText": "Sched.",
        "hasBets": true,
        "hasPlayerBets": true,
        "hasStats": true,
        "hasStandings": true,
        "homeCompetitor": {
          "id": 5093,
          "name": "Morocco",
          "symbolicName": "MAR",
          "imageVersion": 1,
          "color": "#E60000"
        },
        "awayCompetitor": {
          "id": 5097,
          "name": "Mali",
          "symbolicName": "MAL",
          "imageVersion": 1,
          "color": "#FFFFFF"
        },
        "venue": {
          "id": 8346,
          "name": "Stade Prince Moulay Abdallah"
        },
        "promotedPredictions": {
          "playersBetsPredictions": [
            {
              "id": -2069462872,
              "type": 59,
              "title": "To Score at Any Time",
              "totalVotes": 174,
              "odds": {
                "lineId": 1656121385,
                "gameId": 4365029,
                "bookmakerId": 14,
                "athleteId": 57415,
                "bookmaker": {
                  "id": 14,
                  "name": "Bet365",
                  "color": "#007B5B"
                },
                "options": [
                  {
                    "num": 1,
                    "name": "Yes",
                    "rate": {
                      "decimal": 2.62,
                      "fractional": "13/8",
                      "american": "+162"
                    },
                    "trend": 3
                  }
                ]
              },
              "options": [
                {
                  "num": 1,
                  "name": "Yes",
                  "vote": {
                    "count": 167,
                    "percentage": 96
                  }
                },
                {
                  "num": 2,
                  "name": "No",
                  "vote": {
                    "count": 7,
                    "percentage": 4
                  }
                }
              ]
            }
          ]
        }
      }
    }
  ],
  "sports": [...],
  "countries": [...],
  "competitions": [...],
  "competitors": [...]
}

Response Fields

Athlete Object

Field	Type	Description
id	number	Unique athlete identifier
name	string	Full athlete name
shortName	string	Abbreviated display name
clubId	number	Current club/team ID
nationalTeamId	number	National team ID (if applicable)
nationalityName	string	Nationality country name
age	number	Current age in years
position	object	General playing position
formationPosition	object	Specific formation position
nextGame	object	Upcoming match details

Next Game Object

Field	Type	Description
id	number	Unique game identifier
competitionId	number	Competition ID
competitionDisplayName	string	Full competition name with stage
startTime	string	ISO 8601 timestamp with dynamic timezone offset
statusText	string	Game status (e.g., “Scheduled”, “Live”)
homeCompetitor	object	Home team details
awayCompetitor	object	Away team details
venue	object	Match venue information
hasBets	boolean	Whether betting lines are available
hasPlayerBets	boolean	Whether player prop bets are available
promotedPredictions	object	Featured betting predictions

Player Bets Prediction Object

Field	Type	Description
type	number	Bet type ID (57=First Goalscorer, 58=Last Goalscorer, 59=Anytime Scorer)
title	string	Bet type name
totalVotes	number	Number of community votes
odds	object	Bookmaker odds details
options	array	Voting options with percentages

Odds Object

Field	Type	Description
lineId	number	Unique betting line identifier
bookmakerId	number	Bookmaker identifier
athleteId	number	Athlete ID for this prop bet
bookmaker	object	Bookmaker details (name, color)
options	array	Betting options with rates

Rate Object

Field	Type	Description
decimal	number	Decimal odds format (e.g., 2.62)
fractional	string	Fractional odds format (e.g., “13/8”)
american	string	American odds format (e.g., “+162”)

Player Bet Types

Type ID	Name	Description
57	First Goalscorer	Player scores the first goal
58	Last Goalscorer	Player scores the last goal
59	To Score at Any Time	Player scores at any point

Trend Values

Value	Meaning
1	Odds decreasing (better for bettor)
2	Odds stable
3	Odds increasing (worse for bettor)

Use Cases

Player Betting Hub

Display upcoming games for tracked athletes with player prop bets

Match Preview

Show detailed match information for an athlete’s next fixture

Odds Comparison

Compare betting odds across different bet types for a player

Fan Engagement

Display community voting predictions for player performance

Authorizations

x-api-key · string · header · required

Your SportsAPI Pro API key

Query Parameters

athleteId · integer · required

Player ID

Example:

12345

Response

200

Player's next game retrieved successfully