Integration GuidesDocs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Competitions

Provides a list of all available Soccer competitions.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
⏱️

Update Frequency

TTL / Cache: 300 seconds

Data Updates: Tournaments are added within 4 hours of official publication


Data Points

Category & Sport
AttributeParent ElementTypeDescription
country_codecompetition - categoryStringCountry code for a competition category

ex. ENG (England)
idcompetition - categoryStringUnique category ID for a competition

ex. sr:category:1
namecompetition - categoryStringName for a competition category

ex. England (Premier League)
Competition
AttributeParent ElementTypeDescription
alternative_namecompetitionStringAlternate name of a competition

ex. English Premier League (instead of Premier League)
gendercompetitionStringGender for a competition

ex. men
idcompetitionStringUnique ID for a competition

ex. sr:competition:17 (Premier League)
namecompetitionStringName of a competition

ex. Premier League
parent_idcompetitionStringUnique parent ID for a competition. Typically present for group stage or playoff competitions

ex. sr:competition:945 used to link competitions together, like the World Cup and the various qualifiers.
Path Params
string
enum
required
Defaults to trial

The access level of your API key

trial, production

Allowed:
string
enum
required
Defaults to en

2-letter code for supported languages

da (Danish), de (German), el (Greek), en (English), es (Spanish), fi (Finnish), fr (French), id (Indonesian), it (Italian), ja (Japanese), nl (Dutch), pt (Portuguese), ru (Russian), sr (Serbian), srl (Serbian Latin), th (Thai), tr (Turkish), zh (Chinese - simplified), zht (Chinese - traditional)

The above codes are the fully supported languages for this API. Click here for valid language codes and a tabular list of available languages per competition.

string
enum
required
Defaults to json

Format returned

json, xml

Allowed:
Response

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json