Skip to content
API reference / Soccer
GET/soccer/leagues

Get soccer leagues

Returns a list of all available soccer leagues

In the plans that cover this sportNo charge per call without a key (x402)

Parameters

  • futurestring · query

    Filter to leagues with future matches (true)

Response

JSON with success, the result in data, and where the endpoint pages its results meta.

  • dataarray of object
  • divisionsarray of string

    Divisions: the separate competitions the data provider files under this one id (soccer only, e.g. the five Regionalliga divisions). Filter matches of one division with league_name.

  • gidinteger
  • idinteger
  • namestring
  • name_sourcestring
  • official_namestring

    OfficialName: the competition's name without country and stage, from the official source, Wikidata or the data provider (NameSource); stable when a sponsor renames the league. Name stays the provider's ("Country: League"), the value the league_name filters take.

  • errorobject
  • codestring
  • messagestring
  • metaobject
  • attributionstring

    Attribution a data source's licence asks for (Cricsheet's history).

  • limitinteger
  • offsetinteger
  • totalinteger
  • successboolean

Errors

StatusCodeWhen
401UNAUTHORIZEDThe key is missing, mistyped or was rotated.
403FORBIDDENThe sport or feature is not in your plan (FEATURE_NOT_IN_PLAN for Insights and other plan features).
500INTERNAL_ERROROur side. Try again after a few seconds and check the status page.

All errors have the shape described in Errors and limits.

Generated from the OpenAPI file, version 1.0. See it as JSON

Was this page helpful?