API ReferenceLeagues
League Stats Summary
Get aggregate statistics about all leagues
League Stats Summary
GET /v1/leagues/stats/summary
Get aggregate statistics about all leagues in the database including counts by sport, tier, and status.
Request
curl -X GET "https://api.altsportsleagues.ai/v1/leagues/stats/summary" \
-H "Authorization: Bearer YOUR_API_KEY"Response
{
"data": {
"total_leagues": 847,
"by_status": {
"active": 612,
"inactive": 180,
"pending": 55
},
"by_tier": {
"1.x": 23,
"2.x": 145,
"3.x": 389,
"4.x": 290
},
"top_sports": [
{ "sport": "soccer", "count": 156 },
{ "sport": "basketball", "count": 89 },
{ "sport": "combat_sports", "count": 72 }
]
},
"meta": {
"api_version": "v1",
"timestamp": "2026-03-07T21:00:00Z"
}
}