Athlete's Next Game

GET

athletes

nextGame

Player's Next Game

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

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.sportsapipro.com/v1/basketball/athletes/nextGame', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.sportsapipro.com/v1/basketball/athletes/nextGame",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.sportsapipro.com/v1/basketball/athletes/nextGame"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.sportsapipro.com/v1/basketball/athletes/nextGame")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

Endpoint

GET https://api.sportsapipro.com/v1/football/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 -X GET "https://api.sportsapipro.com/v1/football/athletes/nextGame?athletes=57415&fullDetails=true" \
  -H "x-api-key: YOUR_API_KEY"

const response = await fetch(
  "https://api.sportsapipro.com/v1/football/athletes/nextGame?athletes=57415&fullDetails=true",
  {
    headers: { "x-api-key": "YOUR_API_KEY" }
  }
);
const data = await response.json();

import requests

response = requests.get(
    "https://api.sportsapipro.com/v1/football/athletes/nextGame",
    params={"athletes": 57415, "fullDetails": "true"},
    headers={"x-api-key": "YOUR_API_KEY"}
)
data = response.json()

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

Last modified on June 29, 2026

Player's Next Game

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

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.sportsapipro.com/v1/basketball/athletes/nextGame', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.sportsapipro.com/v1/basketball/athletes/nextGame",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.sportsapipro.com/v1/basketball/athletes/nextGame"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.sportsapipro.com/v1/basketball/athletes/nextGame")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

API Reference

Guides

Popular Sports

Team Sports

Racquet & Precision Sports

Specialty Sports

V3 API

V4 Odds API

V6 AiScore API

V1 Legacy

Football V1

Basketball V1

Tennis V1

Hockey V1

Endpoint

Description

Parameters

Request

Response

Response Fields

Athlete Object

Next Game Object

Player Bets Prediction Object

Odds Object

Rate Object

Player Bet Types

Trend Values

Use Cases

Player Betting Hub

Match Preview

Odds Comparison

Fan Engagement

Authorizations

Query Parameters

Response

​Endpoint

​Description

​Parameters

​Request

​Response

​Response Fields

​Athlete Object

​Next Game Object

​Player Bets Prediction Object

​Odds Object

​Rate Object

​Player Bet Types

​Trend Values

​Use Cases

Player Betting Hub

Match Preview

Odds Comparison

Fan Engagement

Authorizations

Query Parameters

Response

Endpoint

Description

Parameters

Request

Response

Response Fields

Athlete Object

Next Game Object

Player Bets Prediction Object

Odds Object

Rate Object

Player Bet Types

Trend Values

Use Cases