List Players
Retrieve all players with optional filtering
List Players
Retrieve all players with optional filtering
Endpoint
GET /api/v1/data/playersAuthentication
Required. Use x-api-key header.
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
division | string | No | Filter by division: M (men), W (women), X (mixed) |
page | integer | No | Page number (default: 1) |
limit | integer | No | Results per page (default: 50, max: 200) |
Example Request
curl -X GET "https://api.altsportsdata.com/api/v1/data/players?division=M&limit=20" \
-H "x-api-key: YOUR_API_KEY"import requests
headers = {'x-api-key': 'YOUR_API_KEY'}
response = requests.get(
'https://api.altsportsdata.com/api/v1/data/players?division=M&limit=20',
headers=headers
)
data = response.json()
print(data)const response = await fetch('https://api.altsportsdata.com/api/v1/data/players?division=M&limit=20', {
method: 'GET',
headers: {
'x-api-key': 'YOUR_API_KEY'
}
});
const data = await response.json();
console.log(data);const response = await fetch('https://api.altsportsdata.com/api/v1/data/players?division=M&limit=20', {
method: 'GET',
headers: {
'x-api-key': 'YOUR_API_KEY'
}
});
const data: any = await response.json();
console.log(data);require 'net/http'
require 'json'
uri = URI('https://api.altsportsdata.com/api/v1/data/players?division=M&limit=20')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Get.new(uri)
request['x-api-key'] = 'YOUR_API_KEY'
response = http.request(request)
data = JSON.parse(response.body)package main
import (
"fmt"
"io"
"net/http"
)
func main() {
client := &http.Client{}
url := "https://api.altsportsdata.com/api/v1/data/players?division=M&limit=20"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Set("x-api-key", "YOUR_API_KEY")
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}using System;
using System.Net.Http;
using System.Threading.Tasks;
var client = new HttpClient();
client.DefaultRequestHeaders.Add("x-api-key", "YOUR_API_KEY");
var response = await client.GetAsync("https://api.altsportsdata.com/api/v1/data/players?division=M&limit=20");
var content = await response.Content.ReadAsStringAsync();
Console.WriteLine(content);import java.net.HttpURLConnection;
import java.net.URL;
import java.io.BufferedReader;
import java.io.InputStreamReader;
public class ApiRequest {
public static void main(String[] args) throws Exception {
String urlString = "https://api.altsportsdata.com/api/v1/data/players?division=M&limit=20";
URL url = new URL(urlString);
HttpURLConnection conn = (HttpURLConnection) url.openConnection();
conn.setRequestMethod("GET");
conn.setRequestProperty("x-api-key", "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": [
{"id": "player-001", "name": "John Smith", "division": "M", "team": "Team 1", "position": "Lead", "seasonsActive": 5},
{"id": "player-002", "name": "Jane Doe", "division": "M", "team": "Team 1", "position": "Skip", "seasonsActive": 8}
],
"pagination": {"page": 1, "limit": 20, "total": 150, "hasMore": true}
}Response Fields
| Field | Type | Description |
|---|---|---|
id | string | Player identifier |
name | string | Player name |
division | string | Division code |
team | string | Current team |
position | string | Position |
seasonsActive | integer | Number of seasons active |