API Reference

Get matches

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

Returns a list of matches

Caching: 5 min

Query params (AND)

Query Params
string
required

Your Client ID from Fans United Client API.

string

A list of comma-separated competition IDs

string

A list of comma-separated country IDs

string

Date-time string in the following format: “2020-01-06T08:55:00Z“

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
Defaults to 20

You can choose the number of matches returned by the request. Default is 20. Maximum is 500.

string

A list of comma-separated match IDs

integer
Defaults to 1

Choose the page in the result set. Starts from 1.

string
enum
Defaults to false

Show deleted matches.

Allowed:
string

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

string
enum
Defaults to asc

The direction of the sorting: ascending or descending.

Allowed:
string
enum

A list of comma-separated labels: Any of: “upcoming”, “live”, ”finished”

Allowed:
string

A list of comma-separated team IDs. It will return all matches from any combination from 1 to 50 teams.

string

Date-time string in the following format: “2020-01-06T08:55:00Z“

Response

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