Search⌘ K
AI Features

Fixtures: Head to Head

Explore how to use the head to head endpoint in API-Football to access detailed fixtures data between two teams, including match results, goals, timestamps, and venues. Understand how to filter this data by league or season to customize your soccer data retrieval.

The head to head endpoint can be used to get the results of fixtures between any two teams. It provides other information such as the timestamps for full and half times, the number of goals scored by each team, and the venue of the match. Its base URI is https://v3.football.api-sports.io/fixtures/headtohead.

This endpoint is updated every 15 seconds.

Team A head-to-head with team B

Query parameters

The following ...