Leagues
Route Guide
Get League
Get comprehensive information about a single sports league by its ID.
Route Reference
Method, path, and environment
GETAuthenticate with X-API-Key
Full route
https://api.altsportsdata.com/api/v1/public/leagues/{league_id}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.
Path Parameters
league_idstringrequired
Unique league identifier (e.g., "nfl", "nba", "premier-league")
Optional
Responses
200OK
200
OK
Response body
{
"data": {
"id": "nfl",
"name": "National Football League",
"sport": "American Football",
"sport_bucket": "football",
"archetype": "professional",
"category": "team_sport",
"country": "US",
"region": "North America",
"tier": "T1",
"founded": 1920,
"active": true,
"teams_count": 32,
"avg_attendance": 67254,
"social_media": {
"twitter": "@NFL",
"instagram": "@nfl",
"followers_total": 45000000
},
"website": "https://www.nfl.com",
"description": "The premier professional American football league",
"logo_url": "https://cdn.altsportsdata.com/leagues/nfl.png"
},
"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.