Get events

get

https://sports.fansunitedapi.com/v1/events

Returns a paginated list of events. When event_ids is provided, only those events are returned and all other filters are ignored. Otherwise the remaining filters (competition_id, season_id, stage_id, sport, status, competitor_ids) are combined with AND; competitor_ids matches when either competitor is one of the given competitors.

Query Params

client_id

string

required

Client ID

competition_ids

string

Comma-separated competition IDs (e.g. fb:c:1,fb:c:2)

competitor_ids

string

Comma-separated competitor IDs (e.g. fb:t:834,fb:t:835). Matches events where either competitor is one of these competitors

event_ids

string

Comma-separated event IDs (e.g. fbⓂ️1,fbⓂ️2). When provided, all other filters are ignored

from_date

string

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

key

string

required

Client API key

limit

integer

Defaults to 100

The maximum items per page. Defaults to 500

page

integer

Defaults to 1

Page number (1-based). Defaults to 1

season_ids

string

Comma-separated season IDs (e.g. fb:c:1:2025/26)

sort_field

string

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

sort_order

string

enum

Defaults to asc

The direction of the sorting: ascending or descending.

Allowed:

sports

string

Comma-separated sports: FOOTBALL, BASKETBALL, TENNIS, AMERICAN_FOOTBALL, FORMULA_1, HOCKEY

stage_ids

string

Comma-separated stage IDs (e.g. fb:stg:142584)

status

string

Comma-separated statuses: UPCOMING, LIVE, FINISHED

to_date

string

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

Responses

Language

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200List of events

400Bad request - missing required parameters or invalid values

500Internal server error