API ReferenceLeagues
List Leagues
Retrieve a paginated list of all leagues
List Leagues
GET /v1/leagues
Retrieve a paginated list of all leagues in the AltSportsLeagues database. Supports filtering by sport, tier, status, country, and search query.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
sport | string | No | Filter by sport type (e.g., lacrosse, surfing) |
tier | string | No | Filter by tier level (e.g., 2.1, 3.0) |
status | string | No | Filter by status: active, inactive, pending |
country | string | No | Filter by country code (e.g., US, GB) |
search | string | No | Full-text search query |
page | integer | No | Page number (default: 1) |
limit | integer | No | Results per page (default: 20, max: 100) |
Request
curl -X GET "https://api.altsportsleagues.ai/v1/leagues?sport=lacrosse&limit=10" \
-H "Authorization: Bearer YOUR_API_KEY"from altsportsleagues import AltSportsLeagues
client = AltSportsLeagues(api_key="YOUR_API_KEY")
leagues = client.leagues.list(sport="lacrosse", limit=10)import { AltSportsLeagues } from 'altsportsleagues';
const client = new AltSportsLeagues({ apiKey: 'YOUR_API_KEY' });
const leagues = await client.leagues.list({ sport: 'lacrosse', limit: 10 });Response
{
"data": [
{
"id": "league_nll_001",
"name": "National Lacrosse League",
"sport": "lacrosse",
"archetype": "season-league",
"tier": "2.1",
"country": "US",
"status": "active"
},
{
"id": "league_pll_002",
"name": "Premier Lacrosse League",
"sport": "lacrosse",
"archetype": "tour-series",
"tier": "2.3",
"country": "US",
"status": "active"
}
],
"meta": {
"total": 47,
"page": 1,
"limit": 10,
"has_more": true,
"api_version": "v1",
"timestamp": "2026-03-07T21:00:00Z"
}
}