API Reference

Get Matches (Search)

get
https://football-feeds.cortextech.io/v1/matches/search

Free-text search across matches by team name and/or competition name, with optional date range filtering.

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.

string
Defaults to opta

The provider that the data was received from

boolean
Defaults to true

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

integer
Defaults to 50

The number of matches 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
Defaults to GLOBAL

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

Responses

Updated 5 days ago

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

Updated 5 days ago

Did this page help you?