Introduction
Responses of the Seasons endpoint are limited to Seasons of the Leagues available in the Plan you are subscribed to. Responses provide you details about for example the Season ID, Name, League ID, Year and if the Season is Active Yes or No.
One of the main features of the Seasons endpoint is the ability to retrieve full Season Games, (history) Fixtures, Results or Upcoming Fixtures. This can be achieved by using the proper Includes which are listed in the section Endpoint Details.
Filters
Filters: name, league_id
Sorting
You can sort on all fields
Endpoint Details
Below you can find the details for this endpoint.
Example Request
The following code snippets demonstrate how to get all seasons available in this endpoint.
// Get your API tokens here: https://www.sportmonks.com/settings#/api
curl "https://cricket.sportmonks.com/api/v2.0/seasons?api_token=YOURTOKEN"
-H "Accept: application/json"// Get your API tokens here: https://www.sportmonks.com/settings#/api
$client = new GuzzleHttp\Client();
$res = $client->request('GET', 'https://cricket.sportmonks.com/api/v2.0/seasons?api_token=YOURTOKEN', [
'headers' => ['Accept' => 'application/json']
]);// Get your API tokens here: https://www.sportmonks.com/settings#/api
response = requests.get("https://cricket.sportmonks.com/api/v2.0/seasons?api_token=YOURTOKEN")
# Print the status code of the response.
print(response.status_code)// Get your API tokens here: https://www.sportmonks.com/settings#/api
require 'faraday_middleware'
Faraday.new('https://cricket.sportmonks.com/api/v2.0/seasons?api_token=YOURTOKEN', headers: {'Accept' => 'application/json', 'Accept-Encoding' => 'gzip'}).get
// Get your API tokens here: https://www.sportmonks.com/settings#/api
URL url = new URL("https://cricket.sportmonks.com/api/v2.0/seasons?api_token=YOURTOKEN");
HttpURLConnection con = (HttpURLConnection) url.openConnection();
con.setRequestMethod("GET");// Get your API tokens here: https://www.sportmonks.com/settings#/api
import { SportmonksApi } from 'sportmonks';
const sportmonks = new SportmonksApi(__YOUR_API_TOKEN__);
sportmonks.get("https://cricket.sportmonks.com/api/v2.0/seasons?api_token=YOURTOKEN",params).then( function(resp){
//resp.data will contain your data
//resp.meta will contain the meta informations
console.log(resp);
});// Get your API tokens here: https://www.sportmonks.com/settings#/api
package main
import (
"fmt"
"log"
sm "github.com/BialkowskiSz/go-sportmonks"
)
func main() {
sm.SetAPIToken("<YOUR_TOKEN_HERE>")
g, err := sm.Get("https://cricket.sportmonks.com/api/v2.0/seasons?api_token=YOURTOKEN", "", 0, false)
if err != nil {
log.Fatal(err)
}
fmt.Println(string(g))
}Example Response
In the API Reference Guide the example responses of the seasons endpoint are shown.
Test this Endpoint
With our In-Page API Tester you can directly test this Endpoint by clicking the blue button on the right ‘Open Test API’. By adding Includes, Parameters and Variables and clicking the blue button on the right below ‘Send API Request’, you can directly view the API Response. Your Requests and Responses are even stored in your personal API Tester Folder (only when you are logged-in). If you are not logged in the API Tester will use the Free Plan Leagues for your requests.
Questions?
We're always happy to help with code or other questions you might have! Search our documentation, contact support, or get in touch with our sales team.
