List leagues
List leagues
GET
/v1/leagues
Competitions, filterable by popularity, country, search or recent activity. Each carries the kickoff of its latest fixture on record (last_fixture_utc / last_fixture_ts), so a client can tell a live competition from a dormant one.
Parameters
| popular | optional | Set to 1 for popular leagues only. |
| country | optional | Filter by country code as listed by /v1/countries, e.g. DE or GB-ENG, or a region code for continental and international competitions — EUROPE, ASIA, AFRICA, AMERICAS, OCEANIA, WORLD (case-insensitive). An unknown code returns 400 invalid_country. |
| search | optional | Match on league name. |
| include | optional | seasons — adds each league's seasons array (newest first, exactly one marked current, as /v1/leagues/{id} returns it), so one page tells you the valid ?season= values for every league on it. |
| active_since | optional | Unix timestamp (seconds, UTC). Only leagues whose latest fixture on record — played or scheduled — kicks off at or after this instant. Pass "six months ago" to skip the competitions the feed has not seen a match in since; without it every competition is returned, including ones dormant for years. |
| esports | optional | true | false. Defaults to false (real football only); true returns the curated list of active esoccer (e-football) competitions instead. Esoccer requires the Ultra plan — other plans get a 403 insufficient_plan. |
| lang | optional | Localize team & league names (21 languages besides English, e.g. zh-cn, ja, es, de, pt). Missing translations fall back to English. |
| page, per_page | optional | Pagination. |
Example
GET /v1/leagues
curl https://api.5dollarfootballapi.com/v1/leagues
-H "Authorization: Bearer fb_live_your_key"{
"success": 1,
"data": [
{ "id": 3120672213, "name": "Premier League", "short_name": "EPL", "country": { "code": "GB-ENG", "name": "England" }, "is_popular": true, "has_standings": true, "last_fixture_utc": "2026-09-14T19:00:00+00:00", "last_fixture_ts": 1789412400 },
{ "id": 1810150156, "name": "La Liga", "short_name": "LL", "country": { "code": "ES", "name": "Spain" }, "is_popular": true, "has_standings": true, "last_fixture_utc": "2026-09-13T20:00:00+00:00", "last_fixture_ts": 1789329600 }
],
"pagination": { "page": 1, "per_page": 50, "count": 2, "has_more": true }
}Need a key? Create a free account — a working key is issued instantly, no card required.