Get Current Match

get

https://football-feeds.cortextech.io/v1/matches/current

Fetch the current or most-relevant match for a given team. Prioritises live matches, then the nearest result or fixture.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

teamId

string

required

Returns only matches where the home team or away team ID matches any in the list provided. Can be passed through as a comma-delimited list or as multiple paramters (&teamId=X&teamId=Y)

provider

string

Defaults to opta

The provider that the data was received from

status

array of strings

Return only matches that only match the required statuses, can be passed as a comma-delimited list or as multiple parameters (&status=X&status=Y). Can be live, result, fixture and postponed. Default will return live, result and fixture

status

Allowed:

compId

array of int64s

Returns only matches for a given list of ceompetition IDs. Can be sent as a comma-delimited list or as multiple parameters (&compId=X&compId=Y)

compId

summary

boolean

Defaults to false

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.

images

boolean

Defaults to false

Include images for competition and team badges. Used in combination with clientId to indicate whether to use the global image library use a client's images

liveMinute

boolean

Defaults to false

Used in simulate a live match, will pick a random minute within the match to return

clientId

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

Language

Credentials

Loading…

Response

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

application/json

200The current match for the team.

400Bad Request — teamId is required.

401Unauthorized

403Forbidden

404No current match found for the team.

500Internal Server Error