Teams

Team head-to-head matches

Returns the head-to-head match history between two teams, with an aggregate summary (matches played, wins/draws, goals) and a paginated list of matches annotated with each side's score and winner.

Plan: Available on the free plan.

get/teams/{team_id}/h2h/{opponent_id}

Request

  • Base URL: https://footballdata.io/api/v1
  • URL: https://footballdata.io/api/v1/teams/{team_id}/h2h/{opponent_id}
  • Auth: HTTP bearer

Path parameters

team_idinteger required

Primary team ID. Errors with missing_team_ids if absent/invalid.

opponent_idinteger required

Opponent team ID. Must differ from team_id (else invalid_h2h_request). Errors with missing_team_ids if absent/invalid.

Query parameters

league_idinteger

Filter H2H matches to a specific league.

season_idinteger

Filter H2H matches to a specific season.

debugstring

Set to '1' to include a debug block in meta (received GET params, resolved ids, SQL totals, params).

pageinteger

Page number (min 1).

limitinteger

Results per page, clamped between 1 and 100.

Response

Successful response

successboolean
metaMeta

Request metadata: usage counters, plan access, and pagination when applicable.

Example response

{
  "success": true
}

Changes

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