Fixtures

Fixtures by Head to Head

Returns the head to head fixtures of the two teams you’ve requested. For more information, please visit: https://docs.sportmonks.com/football/endpoints-and-entities/endpoints/fixtures/get-fixtures-by-head-to-head

Sportmonks documentation

get/football/fixtures/head-to-head/{firstTeam}/{secondTeam}

Request

  • Base URL
    https://api.sportmonks.com/v3
  • Auth
    • API key in query parameter api_token
    • or API key in header Authorization

Path parameters

firstTeamstring required

The ID of the first team retrieve fixtures from.

secondTeamstring required

The ID of the second team retrieve fixtures from.

Query parameters

includestring

Enrich the API response with more data by using includes. Ex. &include=participants;events

Allowed values: sport, round, stage, group, aggregate, league, season, coaches, tvStations, venue, state, weatherReport, lineups, events, timeline, comments, trends, statistics, periods, participants, odds, premiumOdds, inplayOdds, prematchNews, postmatchNews, metadata, sidelined, predictions, referees, formations, ballCoordinates, scores, xGFixture, pressure, expectedLineups, matchfacts. Pass as a semicolon-separated list (the API rejects comma here), e.g. include=sport;round.

selectstring[]

Select specific fields on the base entity . Read how to select fields in our tutorial .

Selectable fields: id, sport_id, league_id, season_id, stage_id, group_id, aggregate_id, state_id, round_id, venue_id, name, starting_at, result_info, leg, details, length. Pass as a comma-separated list, e.g. select=id,sport_id.

sortBystring[]

Order by specific fields on the base entity . For more information check out this page.

filtersstring

Filter the API response on multiple related entities. There are static filters and dynamic filters.​ Please find the possibilities in the Static and Dynamic Filter tab.

Composable filter expression in the form name1:value1,value2;name2:value3. Available filter names: participantSearch, todayDate, venues, Deleted, markets, bookmakers, WinningOdds, fixturestatisticTypes, eventTypes, lineupdetailTypes, fixtureStates, fixtureLeagues, fixtureGroups, coachCountries, seasonStatisticTypes. Pass as a single string — the API rejects the bare comma-joined value codegen tools emit when this is modeled as an array.

localestring

Translate name fields of the API Response in your selected language. Find more information and which languages are available on our translations page .

order'asc' | 'desc'

Result ordering (asc or desc). Defaults to asc.

per_pageinteger

Items per page (max 50). Defaults to 25.

pageinteger

Page number to fetch. Defaults to 1; pair with response.pagination.has_more to drive iteration.

Response

Success.

timezonestring required

Changes

No recorded changes to this operation across all 1 revision of this API.