API Reference

Get teams

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

Returns a list of teams.

Caching: 1 day

Query Params
string
required

Your Client ID from Fans United Client API.

string

Filter teams from a particular country by providing the country ID.

string
enum

Returns only male or female teams

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

You can choose the number of teams returned in the request. Default is 20. Maximum is 200.

string

Full-text search by name

boolean
enum
Defaults to NONE

Returns only national teams or only clubs

Allowed:
integer
Defaults to 1

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

string

You can filter and order the teams returned by providing a list of comma-separated competition IDs.

string
enum
Defaults to id

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

Allowed:
string
enum
Defaults to asc

The direction of the sorting: ascending or descending.

Allowed:
string

You can filter the teams returned by providing a list of comma-separated team IDs.

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