Get Head To Head

Returns all head-to-head fixtures between two teams across competitions and seasons, with per-team win/loss/draw tallies.

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

The provider that the data was received from

string

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

teamId
array of int64s
required
length between 2 and 2

A list of team IDs to compare, the expected value is 2 team IDs, can be supplied as a comma-delimited list or as separate parameters (?teamId=X,Y or ?teamId=X&teamId=Y)

teamId*
compId
array of int64s

A list of competition IDs to compare across, can be supplied as a comma-delimited list or as separate paramters (?compId=X.Y or ?compId=X&compId=Y)

compId
seasonId
array of integers

A list of season IDs to compare across, can be supplied as a comma-delimited list or separate parameters (?seasonId=X,Y or ?seasonId=X&seasonId=Y)

seasonId
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 competition and team logo image URLs in the payload

boolean
Defaults to true

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

Responses

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