API Reference

Get live scores

get
https://sports.fansunitedapi.com/v1/livescore

Returns events for a given date grouped by competition, optionally filtered by sport, competitions, and event status. Defaults to the current date (UTC) and all sports.

Query Params
string
required

Client ID

string

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

string

Comma-separated competition IDs defining the order of competition groups in the response (e.g. fb:c:3,fb:c:2,fb:c:1). Competitions not listed are appended, ordered by ID

string

Date in yyyy-MM-dd format. Defaults to the current date (UTC)

string

Filter by event status: NOTSTARTED, LIVE, FINISHED

string
required

Client API key

string

Comma-separated matches IDs to filter by (e.g. fbⓂ️1,fbⓂ️2)

string

Filter by sport: FOOTBALL, BASKETBALL, TENNIS, AMERICAN_FOOTBALL, FORMULA_1, HOCKEY

Responses

Updated about 3 hours ago

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

Updated about 3 hours ago