Get Matches (search)

Full-text search for matches by team name or competition name. Returns a paginated list.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string

Returns a list of matches where the home team or away team name matches the value provided. Matches on whole team name only.

string

Returns matches for a given list of competition names. Name is matched on exact string only.

date-time

Returns matches that started after this date. Must follow ISO 8601 format.

date-time

Returns matches that started before this date. Must follow ISO 8601 format.

boolean
Defaults to true

Should the match contain summary information or not. If set to false, all matches will include matches events and officials, which can lead to large responses.

integer
Defaults to 50

The number of items to return per page.

integer
Defaults to 0

Based on the number of items per page [size], it may be required to page through lots of data. The page index is 0-indexed so 0 is the first page of data.

string
Defaults to -date

A single sort field, can be any field returned within the match object. prefixing the field with a "-" will sort descending, otherwise data is sorted ascending

string
enum
Defaults to opta

The provider that the data was received from

Allowed:
string
Defaults to GLOBAL

Used when returning images and for usage tracking. If no client ID is passed, will draw from the global stock images, when a client ID is passed, it will attempt to use a client's version of those images

Responses

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