List Leagues
Retrieve a paginated list of sports leagues with optional filtering.
Method, path, and environment
https://api.altsportsdata.com/api/v1/public/leaguesUse the right pane to validate the route
Choose a language and confirm the environment or base URL.
Paste your API key, then fill in path or query parameters.
Run the request and inspect the live response without leaving this page.
Query Parameters
Filter by sport type
Filter by league archetype
Filter by tier classification
Filter by country code (ISO 3166-1)
Number of results (1-100, default: 100)
Pagination offset (default: 0)
Responses
200OK
OK
Response body
{
"data": [
{
"id": "league_001",
"name": "Premier League",
"sport": "soccer",
"country": "GB",
"tier": "elite",
"archetype": "professional",
"founded": 1992,
"active": true
},
{
"id": "league_002",
"name": "La Liga",
"sport": "soccer",
"country": "ES",
"tier": "elite",
"archetype": "professional",
"founded": 1929,
"active": true
}
],
"meta": {
"total": 156,
"page": 1,
"limit": 10,
"has_more": true,
"api_version": "v1",
"timestamp": "2026-03-07T00:00:00Z"
}
}One of the request parameters is invalid. See the returned message for details.
Authentication headers are missing or invalid. Make sure you authenticate your request with a valid API key.
The requested resource is forbidden.
Too many requests. You hit the rate limit. Use the X-RateLimit headers to confirm when you can retry.
Internal server error. Retry later, and contact support if the issue persists.