API ReferenceLeagues
Evaluate League
Re-evaluate a league with the scoring engine
Evaluate League
Trigger a re-evaluation of a league using the current scoring engine and criteria.
Endpoint
POST /v1/leagues/{league_id}/evaluateAuthentication
Required. Use Bearer token or X-API-Key header.
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
league_id | string | Yes | Unique league identifier |
Example Request
import { AltSportsData } from 'altsportsdata';
const client = new AltSportsData({ apiKey: 'YOUR_API_KEY' });
const result = await client.leagues.evaluate('dgpt');
console.log(result.data);from altsportsdata import AltSportsData
client = AltSportsData(api_key='YOUR_API_KEY')
result = client.leagues.evaluate('dgpt')
print(result.data)curl -X POST "https://api.altsportsdata.com/v1/leagues/dgpt/evaluate" \
-H "Authorization: Bearer YOUR_API_KEY"const response = await fetch("https://api.altsportsdata.com/v1/leagues/dgpt/evaluate", {
method: "POST",
headers: {
"Authorization": "Bearer YOUR_API_KEY"
}
});
const result = await response.json();
console.log(result.data);require 'net/http'
require 'json'
uri = URI('https://api.altsportsdata.com/v1/leagues/dgpt/evaluate')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Post.new(uri)
request['Authorization'] = 'Bearer YOUR_API_KEY'
response = http.request(request)
data = JSON.parse(response.body)<?php
$url = 'https://api.altsportsdata.com/v1/leagues/dgpt/evaluate';
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Authorization: Bearer YOUR_API_KEY'
]);
$response = curl_exec($ch);
$data = json_decode($response, true);
curl_close($ch);
?>using System;
using System.Net.Http;
using System.Threading.Tasks;
var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_API_KEY");
var url = "https://api.altsportsdata.com/v1/leagues/dgpt/evaluate";
var response = await client.PostAsync(url, null);
var content = await response.Content.ReadAsStringAsync();
Console.WriteLine(content);package main
import (
"fmt"
"io"
"net/http"
)
func main() {
client := &http.Client{}
url := "https://api.altsportsdata.com/v1/leagues/dgpt/evaluate"
req, _ := http.NewRequest("POST", url, nil)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}import java.net.HttpURLConnection;
import java.net.URL;
import java.io.BufferedReader;
import java.io.InputStreamReader;
public class EvaluateLeague {
public static void main(String[] args) throws Exception {
String urlString = "https://api.altsportsdata.com/v1/leagues/dgpt/evaluate";
URL url = new URL(urlString);
HttpURLConnection conn = (HttpURLConnection) url.openConnection();
conn.setRequestMethod("POST");
conn.setRequestProperty("Authorization", "Bearer YOUR_API_KEY");
BufferedReader in = new BufferedReader(
new InputStreamReader(conn.getInputStream())
);
String line;
StringBuilder response = new StringBuilder();
while ((line = in.readLine()) != null) {
response.append(line);
}
in.close();
System.out.println(response.toString());
}
}Example Response
{
"data": {
"league_id": "dgpt",
"league_name": "Disc Golf Pro Tour",
"evaluation_status": "completed",
"previous_scores": {
"tier_score": 698,
"readiness_score": 712,
"qualification_score": 745
},
"new_scores": {
"tier_score": 723,
"readiness_score": 758,
"qualification_score": 782
},
"changes": {
"tier_score": 25,
"readiness_score": 46,
"qualification_score": 37
},
"tier_change": false,
"previous_tier": "T2",
"new_tier": "T2",
"evaluated_at": "2026-03-07T06:41:00Z"
},
"meta": {
"total": 1,
"page": 1,
"limit": 1,
"has_more": false,
"api_version": "v1",
"timestamp": "2026-03-07T06:41:00Z"
}
}Response Fields
| Field | Type | Description |
|---|---|---|
league_id | string | Unique league identifier |
league_name | string | League name |
evaluation_status | string | Status: completed, in_progress, failed |
previous_scores | object | Scores before evaluation |
new_scores | object | Updated scores after evaluation |
changes | object | Score changes (new - previous) |
tier_change | boolean | Whether tier classification changed |
previous_tier | string | Tier before evaluation |
new_tier | string | Tier after evaluation |
evaluated_at | string | ISO 8601 timestamp of evaluation |