DocsAPI ReferenceMCPSDKs
AltSportsData
Leagues
Route Guide

League Stats

Retrieve aggregated statistics and summary data across all leagues in the database.

Route Reference

Method, path, and environment

GETAuthenticate with X-API-Key
Full route
https://api.altsportsdata.com/api/v1/public/leagues/stats/summary
Base URL
https://api.altsportsdata.com
Testing Flow

Use the right pane to validate the route

01

Choose a language and confirm the environment or base URL.

02

Paste your API key, then fill in path or query parameters.

03

Run the request and inspect the live response without leaving this page.

Query Parameters

sportstring

Filter stats by sport type

Soccer
tierstring

Filter stats by tier (T1, T2, T3, T4)

T1
regionstring

Filter stats by geographic region

Optional

Responses

200

OK

Response body

{
  "data": {
    "total_leagues": 247,
    "active_leagues": 231,
    "sports_covered": 42,
    "countries_represented": 87,
    "tier_distribution": {
      "T1": 15,
      "T2": 58,
      "T3": 112,
      "T4": 62
    },
    "sport_breakdown": {
      "Soccer": 89,
      "Basketball": 34,
      "American Football": 12,
      "Baseball": 18,
      "Ice Hockey": 15,
      "Other": 79
    },
    "avg_teams_per_league": 24.3,
    "total_teams": 6014,
    "avg_readiness_score": 687,
    "total_events_tracked": 125483
  },
  "meta": {
    "total": 1,
    "page": 1,
    "limit": 1,
    "has_more": false,
    "api_version": "v1",
    "timestamp": "2026-03-07T06:36:00Z"
  }
}
400

One of the request parameters is invalid. See the returned message for details.

401

Authentication headers are missing or invalid. Make sure you authenticate your request with a valid API key.

403

The requested resource is forbidden.

429

Too many requests. You hit the rate limit. Use the X-RateLimit headers to confirm when you can retry.

500

Internal server error. Retry later, and contact support if the issue persists.