API Reference

Get competitions.

get
https://football.fansunitedapi.com/v1/competitions

Returns a list of all available competitions in the API.

Caching: 1 month

attributes (AND):

Query Params
string
required

Your Client ID from Fans United Client API.

string

Comma-separated list of competition IDs.

string

Filter competitions for a particular country.

string
enum

Returns all male or female competitions.

Allowed:
string
required

Client API key

string
enum
Defaults to EN

Determines what language to return the data in (English by default). Available options include BG, RO and EN. If a translation is not available in the requested language, the API will fallback to English.

Allowed:
string

Full-text search by name of competition

string
Defaults to id

The field by which the results will be sorted. ID by default.

string
enum
Defaults to asc

The direction of the sorting: ascending or descending.

Allowed:
string
enum

Returns only the specified type of tournament. Available options include: cup, league, playoff (relegations, promotions, qualifications) or ““

Allowed:
Responses

400

Bad request

404

Resource not found

500

Internal server error

Updated over 1 year ago

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

Updated over 1 year ago