leagues

List 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.

get/leagues

Request

  • Base URL: https://api.5dollarfootballapi.com/v1
  • URL: https://api.5dollarfootballapi.com/v1/leagues
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Query parameters

popularboolean

Set to 1 for popular leagues only.

countrystring

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.

searchstring

Match on league name.

includestring

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_sincestring

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.

esportsboolean

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.

langstring

Localize team & league names (21 languages besides English, e.g. zh-cn, ja, es, de, pt). Missing translations fall back to English.

pageinteger

Pagination.

per_pageinteger

Pagination.

Response

Success

success1 required

Changes

No recorded changes to this operation across all 1 revision of this API.