API Reference

Get Head To Head

get
https://football-feeds.cortextech.io/v1/headtohead

Fetch all historical results between two teams (result-status matches only), plus a win/loss/draw summary per team. Exactly 2 teamId values are required.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
teamId
array of strings
required
length between 2 and 2

The team IDs to compare. It is expected that 2 team IDs will be passed in to this URL. Can be passed as a comma-delimited list or as separate parameters (&teamId=X&teamId=Y)

teamId*
compId
array of strings

A list of competition IDs to compare across, can be provided as a comma-delimited list or as multiple parameters (&compId=X&compId=Y)

compId
season
array of strings

A list of seasons to compare across. Can be provided as a comma-delimited list or as separate parameters (&seasonId=X&seasonId=Y)

season
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.

integer
Defaults to 1000

The number of items to return per page.

boolean
Defaults to true

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

string
Defaults to opta

The provider that the data was received from

boolean
Defaults to true

Should the matches 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.

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?